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an Instrument 


Introduction This chapter introduces you to the basic concepts of bus 

communication and pro\ides information and examples to get you 
started progr ammin g. The exact mnemonics for the commands are 
listed in chapters 5 through 9 of this manual and in the individual 
programming manuals for each module. There are three basic 
operations that can be done with a controller and this instrument via 
the bus. You can: 

1. Set up the instrument and start measurements 

2. Retrieve setup information and measurement results 

3. Send measurement data to the instrument 

Other more complicated tasks are accomplished with a combination of 
these basic functions. 

Chapter 1 deals mainly with how to set up the instrument, how to 
retrieve setup information and measurement results, and how to pass 
data to the controller. This chapter is divided into two sections. The 
first section (page 1-2) concentrates on program syntax, and the second 
section (page 1-12) discusses programming an instrument. 


The programming examples in this manual are written in 
NotG HP Basic 5.0 using an HP 9000 Series 200/300 Controller over HP-IB 

and RS-232C. 
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Programming 

Syntax 


Talking to the 
Instrument 



In general, computers acting as controllers communicate with the 
instrument by passing messages over a remote interface using the I/O 
statements provided in the instruction set of the controller’s host 
language. Hence, the messages for programming the HP 16500A, 
described in this manual, will normally appear as ASCII character 
strings imbedded inside the I/O statements of your controller’s 
program. 


When programming the HP 165(X)A with an HP 16501A connected, 
most of the remote operation of the HP 16501A is transparent. The 
only time a programming command is affected by the presence of an 
HP 16501A is when the number of slots is specified or returned from 
the controller. 


For example, the HP 9000 Series 200/300 BASIC and PASCAL 
language systems use the OUTPUT statement for sending program 
messages to the HP 16500A, and the ENTER statement for receiving 
response messages from the HP 16500A. 

Messages are placed on the bus using an output command and passing 
the device address, program message, and terminator. Passing the 
device address ensures that the program message is sent to the correct 
interface and instrument. 

The following command turns the command headers on: 

OUTPUT < device address > ;":SYSTEM:HEADERON"<terminator> 

< device address > represents the address of the device being 
programmed. 
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ll^ The actual OUTPUT command you use when programming is 
N0t6 'Hr dependent on the controller you are using, the programming language 
you are using, and which interface you are programming over (HP-IB 
orRS-232C). 

Angular brackets" < >," in this manual, enclose words or characters 
that symbolize a program code parameter or a bus command. 

Information that is displayed in quotes represents the actual message 
that is sent across the bus. The message terminator (NL or EOI) is the 
only additional information that is also sent across the bus. 

For HP 9000 Series 200/300 controllers, it is not necessary to type in the 
actual < terminator > at the end of the program message. These 
controllers automatically terminate the program message internally 
when the return key is pressed. 
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Addressing the since HP-IB can address multiple devices through the same interface 
Instrument for card, the device address passed with the program message must 
HP-IB include not only the correct interface code, but also the correct 
instrument address. 

Interface Select Code (Selects Interface). Each interface card has a 
unique interface select code. This code is used by the controller to 
direct commands and communications to the proper interface. The 
default is typically "7" for HP-IB controllers. 

Instrument Address (Selects Instrument). Each instrument on an 
HP-IB bus must have a unique instrument address between decimal 0 
and 30. The device address passed with the program message must 
include not only the correct instrument address, but also the correct 
interface select code. 

DEVICE ADDRESS = (Interface Select Code X1CX)) + (Instrument Address) 

For example, if the instrument address for the HP 16500A is 4 and the 
interface select code is 7, when the program message is passed, the 
routine performs its function on the instrument at device address 704. 

For the HP 16500A, the instrument address is typically set to "7" at the 
factory. This address can be changed in the HP-IB pop-up menu of the 
System Configuration menu. 

AddrOSSing tho since RS-232C can only be connected between two devices through the 
InStruniGnt for interface card, only the correct interface code is required for the 

RS-232C address. 

Interface Select Code (Selects Interface). Each interface card has its 
own interface select code. This address is used by the controller to 
direct commands and communications to the proper interface. 
Generally, the interface select code can be any decimal value between 0 
and 31. This value can be selected through switches on the RS-232C 
interface card in the controller. 

For example, if the interface select code is 20, the device address 
required to communicate over the bus is 20. 
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Message Syntax 


Separator 


Command Syntax 
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To program the instrument over the bus, you must have an 
imderstanding of the command format and structure expected by the 
instrument. The instrument is remotely programmed with program 
messages. These are composed of sequences of program message 
units, with each unit representing a program command or query. A 
program command or query is composed of a sequence of functional 
elements that include separators, headers, program data, and 
terminators. These are sent to the instrument over the system interface 
as a sequence of ASCII data messages. For example: 


PROGRAM MESSAGE UNIT 

.- 1 -. 

OUTPUT XXX;"rSYSTEM:HEADER ON" 


OUTPUT COMMAND - 

DEVICE ADDRESS - 

(OPTIONAL FOR HP 16500A) 

PROGRAM MNEMONICS - 

SEPARATOR - 

DATA - 


leSM/SLH 


The < separator > shown in the program message refers to a blank 
space which is required to separate the program mnemonic from the 
program data. 


A command is composed of a header, any associated data, and a 
terminator. The header is the mnemonic or mnemonics that represent 
the operation to be performed by the instrument. The different types 
of headers are discussed in the following paragraphs. 

Simple Command Header. Simple command headers contain a single 
mnemonic. START and STOP are examples of simple command 
headers typically used in this instrument. The syntax is: 

< program mnemonio < terminator > 
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When program data must be included with the simple command 
header (for example, ;SELECT 1), a separator is added. The syntax is: 

< program mnemonio < separator > < program data> < terminator > 

Compound Command Header. Compound command headers are a 
combination of two or more program mnemonics. The first mnemonic 
selects the subsystem, and the last mnemonic selects the function within 
that subsystem. Additional mnemonics appear between the subsystem 
mnemonic and the function mnemonic when there are additional levels 
within the subsystem that must be transversed. The mnemonics within 
the compound message are separated by colons. For example: 

To execute a single function within a subsystem, use the following: 

:<subsystem>;<function> <separator> <program data> <terminator> 

(For example :SYSTEM:LONGFORM ON) 

To transverse down a level of a subsystem to execute a subsystem 
within that subsystem: 

; < subsystem >: < subsystem >: < function > < separator > < program data > 

< terminator > 

(For example :MMEMORY:LOAD:CONnG "nLE_") 

To execute more than one function within the same subsystem a 
semi-colon is used to separate the functions: 

; < subsystem >: < function > < separator > < data >; < function > < separator > 
<data> < terminator > 

(For example :SYSTEM:LONGFORM ON;HEADER ON) 
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Identical function mnemonics can be used for more than one 
subsystem. For example, in the oscilloscope module the function 
mnemonic RANGE may be used to change the vertical range or to 
change the horizontal range: 

:CHANNEL1:RANGE .4 

- sets the vertical range of channel 1 to 0.4 volts full scale. 

:TIMEBASE: RANGE 1 

- sets the horizontal timebase to 1 second full scale. 

CHANNELl and TIMEBASE are subsystem selectors and determine 
which range is being modified. 

Common Command Header. Common command headers control 
IEEE 488.2 functions within the instrument (such as clear status, etc.). 
Their syntax is: 

*< command header > < terminator > 

No space or separator is allowed between the asterisk and the 
command header. *CLS is an example of a common command header. 
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Query Command 



Co mm and headers immediately followed by a question mark (?) are 
queries. After receiving a query, the instrument interrogates the 
requested function and places the answer in its output queue. The 
output message remains in the queue until it is read or another 
command is issued. When read, the message is transmitted across the 
bus to the designated listener (typically a controller). The logic 
analyzer query ;MACHINEl;TWAVEFORM:RANGE? places the 
current seconds per division full scale range for machine 1 in the 
output queue. The controller input statement; 

ENTER < device address > ;Range 

passes the value across the bus to the controller and places it in the 
variable Range. 

Query commands are used to fmd out how the instrument is currently 
configured. They are also used to get results of measurements made by 
the instrument, with the query actually activating the measurement. 

For example, the oscilloscope command :MEASURE:RISETIME? 
instructs the instrument to measure the risetime of your waveform and 
place the result in the output queue. 


The output queue must be read before the next program message is 
sent. For example, when you send the oscilloscope query 
:MEASURE:RJSETIME? you must follow that query with the 
prc^am statement ENTER Value_risetime to read the result of the 
query and place the result in a variable (Value_risetime). 

Sending another command before reading the result of the query will 
cause the output buffer to be cleared and the current response to be 
lost. This will also generate an error in the error queue. 
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Progrsm H63d6r Program headers can be sent using any combination of uppercase or 
Options lowercase ASCII characters. Instrument responses, however, are 
always returned in uppercase. 

Both program command and query headers may be sent in either 
longform (complete spelling), shortform (abbreviated spelling), or any 
combination of longform and shortform. Either of the following 
examples turn the headers and longform on. 

:SYSTEM:HEADER ON;LONGFORM ON - longform 

:SYST;HEAD ON:LONG ON - shortform 

Programs written in longform are easily read and are almost 
self-documenting. The shortform syntax conserves the amount of 
controller memory needed for program storage and reduces the 
amount of I/O activity. 


Note 



The rules for shortform syntax are shown in the chapter Trogramming 
and Documentation Conventions." 


Program Data Program data is used to convey a variety of types of parameter 

information related to the command header. At least one space must 
separate the command header or query header from the program data. 

< program mnemonio < separator > <data> < terminator > 

When a program mnemonic or query has multiple data parameters a 
comma separates sequential program data. 

<program mnemonio <separator> <data>,<data> <terminator> 

For example, :MENU 0,2 has two data parameters: 0 and 2. 
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Character Program Data. Character program data is used to convey 
parameter information as short alpha or alphanumeric strings. For 
example, the run mode command RMODE can be set to single or 
repetitive. The character program data in this case may be SINGLE or 
REPETmVE. :RMODE SINGLE sets the run mode to single. 

Numeric Program Data. Some command headers require program 
data to be a number. For example, :MENU requires the desired menu 
selection to be expressed numerically. The instrument recognizes 
integers, real numbers, and scientific notation. With the proper prefix, 
the instrument will also recognize binary, octal, and hexadecimal base 
numbers. If no prefix is added, the default is decimal. 


Table 1-1. Numeric Data Prefixes 


Base 

Preflx 

Example 

Binary 

#B 

#B101010 

Octal 

#Q 

#01234567 

Hexadecimal 

#H 

#H123..ABCDEF 

Decimal 

none 

1234567890 


Program 

Message 

Terminator 


The program codes within a data message are executed after the 
program message terminator is received. The terminator may be either 
an NL (New Line) character, an EOI (End-Or-Identify) asserted, or a 
combination of the two. All three ways are equivalent with the exact 
encodings for the program terminators listed in the appendix "Message 
Communication and System Functions." Asserting the EOI sets the 
EOI control line low on the last byte of the data message. The NL 
character is an ASCII linefeed (dedmal 10). 



The NL (New Line) terminator has the same function as an EOS (End 
Of String) and EOT (End Of Text) terminator. 


The EOI terminator only applies to HP-IB. 
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SGiGCting MuitipiG You can send multiple program commands and program queries for 
SubSyStGHflS different subsystems on the same line by separating each command 
with a semicolon. The colon following the semicolon enables you to 
enter a new subsystem. For example: 

< program mnemonio < data >;:< program mnemonio <data> <terminator > 
:MMEMORY:CATALOG?;:SYSTEM:PRINT ALL 


NOtG ISP 


Multiple commands may be any combination of compound and simple 
commands. 


SummGry The following illustration summarizes the syntax for programming over 
the bus. 


OUTPUT COMMAND - 

DEVICE ADDRESS - 

(OPTIONAL FOR HP 16500A) 

PROGRAM MNEMONICS - 

SEPARATOR - 

DATA - 


PROGRAM MESSAGE UNIT 


OU' 
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Programming 
an Instrument 


Initialization To make sure the bus and all appropriate interfaces are in a known 
state, be^ every program with an initialization statement. For 
example: 

CLEAR XXX! initializes the interface of the instrument. 

Then load a predefined configuration file firom the disc to preset the 
instrument to a known state. For example: 

OUTPUT XXX;':MMEMORY:LOAD:CONRG ’DEFAULT_- 

would load the configuration file "DEFAULT " into all of the 
modules and mainframe. Refer to the chapter "Mmemory Subsystem" 
for more information on the LOAD command. 


Note 


The three Xs (XXX) after the "CLEAR" and "OUTPUT" statements in 
the previous examples refer to the device address required for 
programming over either HP>IB or RS*232C. The commands and 
syntax for initializing the instrument are discussed in the chapter 
"Common Commands." 


Refer to your controller manual and programming language reference 
manual for information on initializing the interface. 
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SGiGCtinQ 3 Before you can program a module in the HP 16500A or the HP 16501A 
ModUlG over the bus, you must first select the appropriate module. To select 
the module, use the mainframe command :S£LECT followed by the 
numeric reference for the slot location of the master card for that 
module. For an HP 16500A alone, 1...5 refers to slot A..£ respectively. 
When an HP 16501A is connected, 1...10 refer to slot A.. J. iSELECT 
1 selects the module in slot A, :SELECT 2 selects the module in slot B, 
etc. 


: SELECT 

-0- (SELECTS SYSTEM/INTERMODULE) 

-1- (SELECTS MODULE IN SLOT A) 

-2- (SELECTS MODULE IN SLOT B) 


3- (StLtClS MOUULL in 5LOI C) 


Only available when an 
HP 16501A is connected 


4 - (SELECTS MODULE IN SLOT D) 

5 - (SELECTS MODULE IN SLOT E) 

6 - tSELECTS *iK5DUL£ IN SLOT JF) 

7 - f^LECTS MODULE IN SLOT G) 

8 - (SELECTS MODULE IN SLOT Hi 

$- (SELECTS MODULE IN SLOT I) 

10- (SELECTS MODULE IN SLOT J) 

-1- (SELECTS OPTION 1) 

-2- (SELECTS OPTION 2) 


t6SOOB47 


Figure 1-1. Select Command Tree 
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For example, if the TIME6ASE card for your oscilloscope module is in 
slot B, then the command: 

:SELECT 2 

would select the oscilloscope module. Figure 1-1 shows the command 
tree for the select command. For more information on the select 
command, refer to the chapter "Mainframe Commands." 


Note 



Commands may be sent over the bus for any module while in any menu 
as long as the appropriate module has been selected. 


Example Program This program demonstrates the basic command structure used to 

program a module of the HP 16500A. 


10 CLEAR XXX 

20 OUTPLrr XXX;-:SYSTEM:HEADER ON" 

30 OUTPUT XXX;-:SYSTEM:LONGFORM ON" 

40 DIM Card$[100] 

50 OUTPUT XXX;":CARDCAGE?" 

60 ENTER XXX;Card$ 

70 PRINT Cards 

80 OUTPUT XXX;":MMEM:LOAD:CONFIG TEST 

90 OUTPUT XXX;":SELECT 5" 

100 OUTPUT XXX;":MENU 5.3" 

110 OUTPUT XXX;*:RMODE SINGLE* 

120 OUTPUT XXX;":STARr 


Unitialize instrument interface 
!Tum headers on 
ITum longform on 
{Reserve memory for string variable 
{Verify which modules are loaded 
{Enter result in a string variable 
{Print result of query 
E’,5' { Load configuration file 
{into module in slot E 
{Select module in slot E 
{Select menu for module In slot E 
{Select run mode 
{Run the measurement 


Note 



The three Xs (XXX) after the "OUTPUT" and "ENTER" statements in 
the previous examples refer to the device address required for 
progr amming over either HP-IB or RS-232C. 
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Program Overview 
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Line 10 initializes the instrument interface to a known state, and lines 
20 and 30 turn the headers and longform on. 

Line 50 queries the cardcage to confirm which modules are loaded in 
this m ainfr ame. Then line 70 prints the result of the query on screen. 
In this example the query returns: 


:CARDCAGE -1 .*1,12,11,31,0,0,4,4,5 


The first five numbers returned are the card identification numbers. 
The last five numbers list the module assignment for each card. In this 
example, the response shows that there is an oscilloscope acquisition 
card in slot C which is assigned to the oscilloscope timebase card in slot 
D. Also, there is a logic analyzer card in slot E which is assigned to 
itself. Refer to the chapter "Mainframe Commands" for more 
information on CARDCAGE command. 

Line 80 loads the configuration file "TEST_E" into the module in slot E 
and line 90 selects the module in slot E. Then line 100 displays one of 
menus of the module in slot E. 

Lines 110 and IIQ tell the analyzer to run the measmement configured 
by the file "TEST_E" one time. 


introduction to Programming an Instrument 

1-15 



Receiving 
Information from 
the Instrument 



After receiving a query (command header followed by a question 
mark), the instrument interrogates the requested function and places 
the answer in its output queue. The answer remains in the output 
queue until it is read or another command is issued. When read, the 
message is transmitted across the bus to the designated listener 
(typically a controller). The input statement for receiving a response 
message from an instrument’s output queue typically has two 
parameters;the device address and a format specification for handling 
the response message. For example, to read Ae result of the query 
command :SYSTEM:LONGFORM? you would execute the statement: 

ENTER < device address > ;Setting 

where < device address > represents the address of your device. This 
would enter the current setting for the longform command in the 
numeric variable Setting. 


All results for queries sent in a program message must be read before 
another program message is sent. For example, when you send the 
query iSELECT?, you must follow that query with the program 
statement ENTER Setting to read the result of the query and place the 
result in a variable (Setting). 

Sending another command before reading the result of the query will 
cause the output buffer to be cleared and the current response to be 
lost. This will also cause an error to be placed in the error queue. 

The actual ENTER program statement you use when programming is 
dependent on the programming language you are using. 


The format specification for handling the response messages is 
dependent on both the controller and the programming language. 
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The format of the returned ASCII string depends on the current 
settings of the SYSTEM HEADER and LONGFORM commands. 
The general format is: 

< header > < separator > <data> < terminator > 

The header identifies the data that follows and is controlled by issuing 
a :SYSTEM:HEADER ON/OFF command. If the state of the header 
command is OFF, only the data is returned by the query. The format 
of the header is controlled by the :SYSTEM:LONGFORM ON/OFF 
command. If longform is OFF, the header will be in its shortform and 
the header will vary in length depending on the particular query. The 
following would be returned from a iSELECT? command query. 

<data> <terminator> (with HEADER OFF) 

:SEL<separator> <data> <terminator> (with HEADER ON/LONGFORM OFF) 

:SELECT<separator> <data> <terminator> (with HEADER ON/LONGFORM 
ON) 


A command or query may be sent in either longform or shortform, or 
in any combination of longform and shortform. The HEADER and 
LONGFORM commands only control the format of the returned data 
and have no effect on the way commands are sent. Common 
commands never return a header. 

Refer to chapter 1, "System Subsystem" for information on turning the 
HEADER and LONGFORM commands on and off. 
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Response Data 
Formats 



Numeric Base 


Most data will be returned as exponential or integer numbers. 
However, query data of instrument setups may be returned as 
character data. Interrogating the run mode :RMODE? will return one 
of the following: 

:RMODE REPETrnVE<terminator> (with HEADER ON/LONGFORM ON) 

:RMOD REP<terminator> (with HEADER ON/LONGFORM OFF) 
REPETrnVE<terminator> (with HEADER OFF/LONGFORM ON) 

REP < terminator > (with HEADER OFF/LONGFORM OFF) 


Refer to the individual commands in this manual and in the individual 
programming manuals for each module for information on the format 
(alpha or numeric) of the data returned from each query. 


Most numeric data will be returned in the same base as shown on 
screen. When the prefix #B precedes the returned data, the value is in 
the binary base. Likewise, #Q is the octal base and #H is the 
hexadecimal base. If no prefix precedes the returned numeric data, 
then the value is in the decimal base. 
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string VariablGS if you want to observe the headers for queries, you must bring the 

returned data into a string variable. Reading queries into string 
variables is simple and straightforward, requiring little attention to 
formatting. For example: 

ENTER < device address >; Results 

places the output of the query in the string variable Result$. 

ll^ String variables are case sensitive and must be expressed exactly the 

Not6 'W same each time they are used. 

The output of the instrument may be numeric or character data 
depending on what is queried. Refer to the specific commands for the 
formats and types of data returned from queries. 

* Ilia For the example programs, the device being programmed is at device 
N Ot© ^ir address XXX. The actual address will vary according to how you have 
configured the bus for your own application and whether you are 
programming over HP-IB or RS-232C. 

The following example shows logic analyzer data being returned to a 
string variable with headers off: 

10 OUTPUT XXX;“:SYSTEM:HEADER OFP 
20 DIM Rang$[30] 

30 OUTPUT XXX;*:MACHINE1:TWAVEFORM:RANGE?* 

40 ENTER XXX;Ran 9 $ 

50 PRINT Rang$ 

60 END 

After running this program, the controller displays: 

+ 1.00000E-05 
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Numeric Variables 


Definite-Length 
Block Response 
Data 



If you do not need to see the headers when a numeric value is returned 
from the instrument, then you can use a numeric variable. When you 
are receiving numeric data into a numeric variable, turn the headers 
off. Otherwise the headers may cause misinterpretation of returned 
data. 

The following example shows logic analyzer data being returned to a 
numeric variable. 

10 OUTPUT XXX;“:SYSTEM:HEADER OFF 
20 OUTPUT XXX;":MACHINE1:TWAVEF0RM;RANGE?* 

30 ENTER XXX;Rang 
40 PRINT Rang 
50 END 

After running this program, the controller displays: 


l.E-5 


Definite-length block response data allows any type of 
device-dependent data to be transmitted over the system interface as a 
series of 8-bit binary data bytes. This is particularly useful for sending 
large quantities of data or 8-bit extended ASCII codes. The syntax is a 
pound sign ( # ) followed by a non-zero digit representing the number 
of digits in the decimal integer. After the non-zero digit is the decimal 
integer that states the number of 8-bit data bytes being sent. This is 
followed by the actual data. 


NUMBER OF DIGITS 
THAT FOLLOW 



# 800000080 <ei 


ghty bytes of 


dotoXtermi nator> 


NUMBER OF BYTES 
TO BE TRANSMITTED 


165M/BLZZ 


For example, for transmitting 80 bytes of data, the syntax would be: 

states 


The "8" states the number of di^ts that follow, and 
the number of bytes to be transmitted. 




Indefinite-length block data is not supported on the HP16500A. 
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Multiple Queries 



Instrument Status 
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You can send multiple queries to the instrument within a single 
program message, but you must also read them back within a single 
program message. This can be accomplished by either reading them 
back into a string variable or into multiple numeric variables. For 
example, you could read the result of the query 
:SYSTEM:HEADER?;LONGFORM? into the string variable 
ResultsS with the command: 

ENTER XXX; Ftesults$ 

When you read the result of multiple queries into string variables, each 
response is separated by a semicolon. For example, the response of the 
query :SYSTEM:HEADER?:LONGFORM? with HEADER and 
LONGFORM on would be: 


:SYSTEM:HEADER 1;:SYSTEM:LONGFORM 1 


If you do not need to see the headers when the numeric values are 
returned, then you could use following program message to read the 
query :SYSTEM:HEADERS?;LONGFORM? into multiple numeric 
variables: 


ENTER XXX;Result1 .Result2 


When you are receiving numeric data into numeric variables, the 
headers should be turned off. Otherwise the headers may cause 
misinterpretation of returned data. 


Status registers track the current status of the instrument. By checking 
the instrument status, you can find out whether an operation has been 
completed, whether the instrument is receiving triggers, and more. The 
appendix "Status Reporting" explains how to check the status of the 
instrument. 
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Programming Over HP-iB 


Introduction This chapter desoibes the interface functions and some general 

concepts of the HP-IB. In general, these functions are defined by 
IEEE 488.1 (HP-IB bus standard). They deal with general bus 
management issues, as well as messages which can be sent over the bus 
as bus commands. 

The HP-IB information in this chapter is not affected when an 
HP 16501A is connected to the HP 165{X)A. Therefore, all references 
to the HP 16500A apply whether or not an HP 16501A is connected. 


Interface 

Capabilities 


The interface capabilities of the HP 16500A, as defined by IEEE 488.1 
are SHI, AHl, f 5, TEO, U, LEO, SRI, RLl, PPl, DCl, DTI, CO, and 
E2. For more information, refer to table 6-1 in the chapter "Mainframe 
Commands." 


Command and 
Data Concepts 


The HP-IB has two modes of operation: command mode and data 
mode. The bus is in command mode when the ATN line is true. The 
command mode is used to send talk and listen addresses and various 
bus commands, such as a group execute trigger (GET). The bus is in 
the data mode when the ATN line is false. The data mode is used to 
convey device-dependent messages across the bus. These 
device-dependent messages include all of the instrument commands 
and responses found in chapters 5 through 9 of this manual and in the 
individual programming manuals for each module. 
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Addressing By using the front-panel touchscreen, the HP-IB interface can be 

placed in either talk only mode (Printer) or addressed talk/listen mode 
(Controller) {&&& Hoe, HP 1650QAI16S01A Reference Manual). Talk only 
mode should be used when you want the instrument to talk directly to a 
printer without the aid of a controller. Addressed talk/listen mode is 
used when the instrument will operate in conjunction with a controller. 
When the instrument is in the addressed talk/listen mode, the following 
is true: 

• Each device on the HP-IB resides at a particular address ran g in g 
from 0 to 30. 

• The active controller specifies which devices will talk, and which 
will listen. 

• An instrument, therefore, may be talk addressed, listen 
addressed, or unaddressed by the controller. 

If the controller addresses the instrument to talk, it will remain 
configured to talk until it receives an interface clear message (IFC), 
another instrument’s talk address (OTA), its own listen address 
(MLA), or a universal untalk command (UNT). 

If the controller addresses the instrument to listen, it will remain 
configured to listen until it receives an interface clear message (IFC) its 
own talk address (MTA), or a universal unlisten command (UNL). 


Programming Over HP-IB 
2-2 


HP 16500A/16501A 
Programming Reference 


Communicating 
Over the HP-IB 
Bus (HP 9000 
Series 200/300 
Controller) 
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Since HP-IB can address multiple devices through the same interface 


WM 

Lfcusowu vtauj. lHw ^aw^i.cixu uxwooci^w iiiwov 


emu, LUC ucvicc auuxv 


include not only the correct instrument address, but also the correct 
interface code. 


Interface Select Code (Selects Interface). Each interface card has its 
own interface select code. This code is used by the controller to direct 
commands and communications to the proper interface. The default is 
typically "7" for HP-IB controllers. 

Instrument Address (Selects Instrument). Each instrument on the 
HP-IB port must have a unique instrument address between decimal 0 
and 30. The device address passed with the program message must 
include not only the correct instrument address, but also the correct 
interface select code. 


DEVICE ADDRESS = (Interface Select Code X100) + (Instrument Address) 

For example, if the instrument address for the HP 16500A is 4 and the 
interface select code is 7, when the program message is passed, the 
routine performs its function on the instrument at device address 704. 
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Local, Remote, 
and Local 
Lockout 


The local, remote, and remote with local lockout modes may be used 
for various degrees of front-panel control while a program is running. 
The instrument will accept and execute bus commands while in local 
mode, and the front panel will also be entirely active. If the HP 16500A 
is in remote mode, the instrument will go from remote to local with any 
touchscreen or mouse activity. In remote with local lockout mode, all 
controls (except the power switch) are entirely locked out. Local 
control can only be restored by the controller. 


Note 4^ 


Cycling the power will also restore local control, but this will also reset 
certain HP-IB states. 


The instrument is placed in remote mode by setting the REN (Remote 
Enable) bus control line true, and then addressing the instrument to 
listen. The instrument can be placed in local lockout mode by sending 
the local lockout command (LLO). The instrument can be returned to 
local mode by either setting the REN line false, or sending the 
instrument the go to local command (GTL). 


Programming Over HP-iB 
2-4 


HP 16500A/16501A 
Programming Reference 


Bus Commands 

Device Clear 

Group Execute 
Trigger (GET) 

Interface Clear 
(IFC) 


The following commands are IEEE 488.1 bus commands (ATN true). 
IEEE 488.2 defines many of the actions which are taken when these 
commands are received by an instrument. 


The device clear (DCL) or selected device clear (SDC) commands 
clear the input and output buffers, reset the parser, clear any pending 
commands, and clear the Request-OPC flag. 


The group execute trigger command will cause the same action as the 
START command for Group Run: the instrument will acquire data for 
the active waveform and listing display(s). 


This command halts all bus activity. This includes unaddressii^ all 
listeners and the talker, disabling serial poll on all devices, and 
returning control to the system controller. 
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I ntrod UctiOn This chapter describes the interface functions and some general 

concepts of the RS-232C. The RS-232C information in this chapter is 
not affected when an HP 16501A is connected to the HP 16500A. 
Therefore, all references to the HP 16500A apply whether or not an 
HP 16501A is connected. 


The RS-232C interface on this instrument is Hewlett-Packard’s 


implementation of EIA Recommended Standard RS-232C, "Interface 
Between Data Terminal Equipment and Data Communications 
Equipment Employing Serial Binary Data Interchange." With this 
interface, data is sent one bit at a time and characters are not 
synchronized with preceeding or subsequent data characters. Each 


character is Sent as a complete entity without relationship to other 


events. 


l|g| IEEE 488.2 is designed to work with IEEE 488.1 as the physical 
Note W interface. When RS-232C is used as the physical interface, as much of 
IEEE 488.2 is retained as the hardware differences will allow. No 
IEEE 488.1 messages such as DCL, GET, and END are available. 
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Interface 

Operation 


Cables 


The HP 16500A can be programmed with a controller over RS-232C 
using either a minimum three-wire or extended hardwire interface. 

The operation and exact connections for these interfaces are described 
in more detail in the following sections. 

When you are programming an HP 16500A over RS-232C with a 
controller, you are normally operating directly between two DTE 
(Data Terminal Equipment) devices as compared to operating 
between a DTE device and a DCE (Data Communications 
Equipment) device. 

When operating directly between two RS-232C devices, certain 
considerations must be taken into account. For three-wire operation, 
XON/XOFF must be used to handle protocol between the devices. 

For extended hardwire operation, protocol may be handled either with 
XON/XOFF or by manipulating the CTS and RTS lines of the HP 
16500A. For both three-wire and extended hardwire operation, the 
DCD and DSR inputs to the HP 16500A must remain Wgh for proper 
operation. 

With extended hardwire operation, a high on the CTS input allows the 
HP 16500A to send data and a low on this line disables the HP 16500A 
data transmission. Likewise, a high on the RTS line allows the 
controller to send data and a low on this line signals a request for the 
controller to disable data transmission. 

Since three-wire operation has no control over the CTS input, internal 
pull-up resistors in the HP 165(X)A assure that this line remains high for 
proper three-wire operation. 


Selecting a cable for the RS-232C interface is dependent on your 
specific application. The following paragraphs describe which lines of 
the HP 16500A are used to control the operation of the RS-232C bus 
relative to the HP 16500A. To locate the proper cable for your 
application, refer to the reference manual for your controller. This 
manual should address the exact method your controller uses to 
operate over the RS-232C bus. 
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Minimum 
Three-Wire 
Interface with 
Software 
Protocol 


With a three-wire interface, the software (as compared to interface 
hardware) controls the data flow between the Hr 165(X)A and the 
controller. This provides a much simpler connection between devices 
since you can ignore hardware handshake requirements. The HP 
16500A uses the following connections on its RS-232C interface for 
three-wire communication: 

• Pin 7 SGND (Signal Ground) 

• Pin 2 TD (Transmit Data from HP 165(X)A) 

• Pin 3 RD (Receive Data into HP 165(X)A) 


The TD (Transmit Data) line from the HP 16500A must connect to the 
RD (Receive Data) line on the controller. Likewise, the RD line from 
the HP 16500A must connect to the TD line on the controller. Internal 
pull-up resistors in the HP 16500A assure the DCD, DSR, and CTS 
lines remain high when you are using a three-wire interface. 

Note 


The three-wire interface provides no hardware means to control data 
flow between the controller and the HP 16500A. XON/OFF protocol 
is the only means to control this data flow. 
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Extended 
Interface with 
Hardware 
Handshake 


With the extended interface, both the software and the hardware can 
control the data flow between the HP 165(X)A and the controller. This 
allows you to have more control of data flow between devices. The HP 
16500A uses the following connections on its RS-232C interface for 
extended interface communication: 

• Pin 7 SGND (Signal Ground) 

• Pin 2 TD (Transmit Data from HP 165(X)A) 

• Pin 3 RD (Receive Data into HP 16500A) 

The additional lines you use depends on your controller’s 
implementation of the extended hardwire interface. 

• Pin 4 RTS (Request To Send) is an output from the 

HP 16500A which can be used to control incoming data flow. 

• Pin 5 CTS (Clear To Send) is an input to the HP 16^A which 
controls data flow from the HP 16^A. 

• Pin 6 DSR (Data Set Ready) is an input to the HP 165(X)A 
which controls data flow from the HP 16500A within two bytes. 

• Pin 8 DCD (Data Carrier Detect) is an input to the 

HP 16500A which controls data flow from the HP 16500A within 
two bytes. 

• Pin 20 DTR (Data Terminal Ready) is an output from the 

HP 16500A wUch is enabled as long as the HP 16500A is turned 
on. 

The TD (Transmit Data) line from the HP 16500A must connect to the 
RD (Receive Data) line on the controller. Likewise, the RD line from 
the HP 16500A must connect to the TD line on the controller. 

The RTS (Request To Send), is an output from the HP 16500A which 
can be used to control incoming data flow. A high on the RTS line 
allows the controller to send data and a low on this line signals a 
request for the controller to disable data transmission. 
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The CTS (Clear To Send), DSR (Data Set Ready), and DCD (Data 
Carrier Detect) lines are inputs to the HP 16500A which control data 
flow from the HP 16500A (Pin 2). Internal pull-up resistors in the HP 
16500A assure the DCD and DSR lines remain high when they are not 
connected. 

When DCD or DSR are connected to the controller, the controller 
must keep these lines and the CTS line high to enable the HP 16500A 
to send data to the controller. A low on any one of these lines will 
disable the HP 165(X)A data transmission. Dropping the CTS line low 
during data transmission will stop HP 16500A data transmission 
immediately. Dropping either the DSR or DCD line low during data 
transmission will stop HP 16500A data transmission, but as many as 
two additional bytes may be transmitted from the HP 16500A. 


Cable Example Figure 3-1 is an example of how to connect the HP 16500A to the 

HP 98628 Interface card of an HP 9000 series 200/300 controller. For 
more information on cabling, refer to the reference manual for your 
specific controller. 


Note 



Since this example does not have the correct connections for hardware 
handshake, XON/XOFF protocol must be used when connecting the 
HP 16500A as shown in figure 3-1 


HP 16500A 
REAR PANEL 



(MALE-TO-MALE) DCE opt.002 

(FEMALE-TO-fEMALE) 


HP 98628 
INTERFACE CARD 


l6iM/BL1S 


Figure 3-1. Cable Example 
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Configuring the 
Interface 


Interface 

Capabilities 


Protocol 


By using the front-panel touchscreen, the RS-232C interface can be 
placed in either the printer mode or the controller mode. The printer 
mode should be used when you want the instrument to talk directly to a 
printer over RS-232C without the aid of a controller. The controller 
mode is used when the instrument wiU operate in conjunction with a 
controller over RS-232C. 

If you are not famili ar with how to configure the RS-232C interface, 
refer to the HP 1650QAI16S01A Reference Manual. 


The baud rate, stop bits, parity, protocol, and data bits must be 
configured exactly the same for both the controller and the HP 16500A 
to properly communicate over the RS-232C bus. The HP 16500A 
RS-232C interface capabilities are listed below: 

• Baud Rate: 110,300,600,1200,2400,4800,9600, or 19.2 k 

• Stop Bits: 1,1.5, or 2 

• Parity: None, Odd, or Even 

• Protocol: None or XON/XOFF 

• Data Bits: 8 

NONE. VWth a three-wire interface, selecting NONE for the protocol 
does not allow the sending or recei^dng device to control data flow. No 
control over the data flow increases the possibility of missing data or 
transferring incomplete data. 

With an extended hardwire interface, selecting NONE allows a 
hardware handshake to occur. With hardware handshake, hardware 
signals control data flow. 
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Data Bits 



XON/XOFF. XON/XOFF stands for Transmit On/Transmit Off. \Wth 
this mode the receiver (controller or HP 16500A) controls data flow 
and can request that the sender (HP 16500A or controller) stop data 
flow. By sending XOFF (ASCII 17) over its transmit data line, the 
receiver requests that the sender disables data transmission. A 
subsequent XON (ASCII 19) allows the sending device to resume data 
transmission. 


A controller sending data to the HP 16500A should send no more than 
32 bytes of data after an XOFF. 

The HP 16500A will not send any data after an XOFF is received until 
an XON is received. 


Data bits are the number of bits sent and received per character that 
represent the binary code of that character. The HP 16500A supports 
the 8-bit binary code. 


The controller must be in the 8-bit mode to properly communicate over 
theRS-232C. 


For more information on the RS-232C interface, refer to the HP 
165(X)A Reference Manual. For information on RS-232C voltage levels 
and connector pinouts, refer to the HP 1650QAH6501A Service Manual, 
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Communicating 
Over the 
RS-232C Bus 
(HP 9000 
Series 200/300 
Controiier) 


Lockout 

Command 


Note SSi 


Each RS-232C interface card has its own interface select code. This 
code is used by the controller to direct commands and communications 
to the proper interface. Unlike HP-IB, which allows multiple devices 
to be connected through a single interface card, RS-232C is only 
connected between two devices at a time through the same interface 
card. Because of this, only the interface code is required for the dewce 
address. 

Generally, the interface select code can be any decimal value between 0 
and 31, except for those interface codes which are reserved by the 
controller for internal peripherals and other internal interfaces. This 
value can be selected throi^ switches on the interface card. For more 
information, refer to the reference manual for your interface card or 
controller. 

For example, if your RS-232C interface select code is 20, the device 
address required to communicate over the RS-232C bus is 20. 


To lockout the front panel controls use the system command 
LOCKOUT. When this function is on, all controls (except the power 
switch) are entirely locked out. Local control can only be restored by 
sending the command :LOCKOUT OFF. For more information on 
this command see the chapter "Mainframe Commands" in this manual. 


Cycling the power will also restore local control, but this also reset 
certain RS-232C states. 
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Conventions 


Introduction 


Truncation Ruie 


This chapter covers the programming conventions used in 
programming the instrument, as well as the documentations 
conventions used in this manual. This chapter also contains a detailed 
description of the command tree and command tree traversal. 


The truncation rule for the mnemonics used in headers and alpha 
arguments is: 

• The mnemonic is the first four characters of the keyword unless 
the fourth character is a vowel, then the mnemonic is the first 
three characters of the keyword. 

This rule wU not be used if the length of the keyword is exactly four 
characters. When the keyword only contains four characters, there is 
no shortform of the command. 

Some examples of how the truncation rule is applied to various 
commands are shown in table 4-1. 
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Table 4-1. Mnemonic Truncation 


The Command 
Tree 


Command Types 


Example: 


Example: 


Longform 

Shoitform 

START 

STAR 

CARDCAGE 

CARD 

MENU 

MENU 

SELECT 

SEL 

PATTERN 

PATT 


The command tree (figure 4-1) shows all commands in the HP 16500A 
mainframe and the relationship of the commands to each other. You 
should notice that the common commands are not actually included 
with the command tree. After a < NL > (linefeed - ASCII dedmal 
10) has been sent to the instrument, the parser will be set to the "root" 
of the command tree. 


The commands for this instrument can be placed into three types. The 
three types are: 

Common Commands. Common commands are independent of the 
tree, and do not affect the position of the parser wthin the tree. 

•*CLS" 

Mainframe Commands. The mainframe commands reside at the root 
of the command tree. These commands are always parsable if they 
occur at the beginning of a program message, or are preceded by a 
colon. 

•:SELECT V 

Subsystem Commands. Subsystem commands are grouped together 
imder a common node of the tree, such as the MMEMORY commands. 


Programming and Documentation Conventions 
4-2 


HP 16500A/16501A 
Programming Reference 








SELect 0 


Conmon 

Commands 

»CLS 

• ESE 
•ESR 
*IDN 
*IST 
*OPC 
*OPT 
.PRE 
*RST 
»SRE 
•STB 

• TRG 
•TST 
•WAI 


SYSTem MMEMory INTermodule 


1_ 

BEEPer 

DATA 

AUTo1ood 

1 

DELete 

CAPobi1ily 

DSP 

CAT 0 1og 

HTIMe 

CARDcoge 

ERRor 

COPY 

INPort 

CESE 

HEADer 

DOWNIood 

INSert 

CESR 

LONGform 

INITia 1ize 

SKEW<N> 

EOI 

PRINt 

load::CON fig] 

TREE 

LER 

SETUP 

LOAD:lASSemb1er 

TTIMe 

LOCKoul 


MSI 


MENU 


PACK 


MESE<N> 


PURge 


M£SR<iN> 




RMODe 


STORel:CONfig] 


SELect 


UPLoad 


SETColor 




STARt 




STOP 



16500645 


Figure 4-1. The HP 16500A Mainframe Command Tree 
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Tree Traversal 
Rules 


Examples 


Example 1; 


Command headers are created by traversing down the command tree. 
A legal command header from the command tree in figure 4-1 would 
be ":MMEM:INrnALJZE." This is referred to as a compound header. 
A compound header is a header made of two or more mnemonics 
separated by colons. The mnemonic created contains no spaces. The 
following rules apply to traversing the tree: 

• A leading colon or a < program message terminator > (either a 
< NL > or EOI true on the last byte) places the parser at the 
root of the command tree. A leading colon is a colon that is the 
first character of a program header. 

• Executing a subsystem command places you in that subsystem 
(until a leading colon or a < program message terminator > is 
found). In the Command Tree, figure 4-1, use the last mnemonic 
in the compound header as a reference point (for example 
INITIALIZE). Then find the last colon above that mnemonic 
(MMEM:), and that is where the parser will be. Any command 
below that point can be sent within the current program message 
without sending the mnemonic(s) which appear above them 
(STORE, etc.). 


The following examples are written using HP BASIC 5.0 on a HP 9000 
Series 200/300 Controller. The quoted string is placed on the bus, 
followed by a carriage return and linefeed (CRLF). 

The three Xs (XXX) shown in this manual after an ENTER or 
OUTPUT statement refers to the device address for either HP-IB or 
RS-232C. 


OUTPUT XXX;':SYSTEM:HEADER ON:LONGFORM ON' 

In example 1, the colon between SYSTEM and HEADER is necessary 
since SYSTEM:HEADER is a compound command. The semicolon 
between the HEADER command and the LONGFORM command is 
the required < program message unit separator >. The LONGFORM 
command does not need SYSTEM preceding it, since the 
SYSTEMrHEADER command sets the parser to the SYSTEM node 
in the tree. 
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Example 2: 


Example 3: 
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OUTPUT XXX;‘:MMEMORY:INmALIZE;STORE ’FILE_’,’RLE DESCRIPTION" 
or 

OUTPUT XXX;":MMEMORY;INITIALIZP 

OUTPUT XXX;“:MMEMORY:STORE ■FILE_’,’FILE DESCRIPTION" 

In the first line of example 2, the "subsystem selector" is implied for the 
STORE command in the compound command. The STORE 
command must be in the same program message as the INITIALIZE 
command, since the < program message terminator > will place the 
parser back at the root of the command tree. 

A second way to send these commands is by placing "MMEMORY;" 
before the STORE command as shown in the fourth line of example 2. 

OUTPUT XXX,":MMEM:CATALOG?::SYSTEM;PRINT ALL" 

In example 3, the leading colon before SYSTEM tells the parser to go 
back to the root of the command tree. The parser can then see the 
SYSTEM:PRINT command. 
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Infinity 

Representation 


TThe representation of infinity is 9.9E+37 for real numbers and 32767 
for integers. This is also the value returned when a measurement 
cannot be made. 


Sequential and 

Overlapped 

Commands 


IEEE 488.2 makes the distinction between sequential and overlapped 
co mm ands. Sequential commands finish their task before the 
execution of the next command starts. Overlapped commands run 
concurrently, and therefore the command following an overlapped 
command may be started before the overlapped command is 
completed. Some examples of overlapped commands on the HP 
165()0A are: 


STAFTT 

STOP 


Response 

Generation 


IEEE 488JZ defines two times at which query responses may be 
buffered. The tirst is when the query is parsed by the instrument and 
the second is when the controller addresses the instrument to talk so 
that it may read the response. The HP 16500A wiU buffer responses to 
a query when it is parsed. 
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The following conventions are used in this manual in descriptions of 
remote and operation* 

< > Angular brackets enclose words or characters that are used to 
symbolize a program code parameter or a bus command. 

"is defined as." For example, A ::= B indicates that A can be 
replaced by B in any statement containing A . 

1 "or": Indicates a choice of one element from a list. For example, 

A I B indicates A or B, but not both. 

... An ellipsis (trailing dots) is used to indicate that the preceding 
element may be repeated one or more times. 

[ ] Square brackets indicate that the enclosed items are optional. 

{ } When several items are enclosed by braces, one, and only one of 
these elements must be selected. 

XXX Three Xs after an ENTER or OUTPUT statement refer to the 
device address for HP-IB or RS-232C. 

The following definitions are used: 

d :: = A single ASCII numeric character, 0-9. 

n :: = A single ASCII non-zero, numeric character, 1-9. 

< NL > :: = Linefeed (ASCII decimal 10). 

<sp> < white space > 

white space = 0 through 32 (decimal) except linefeed (decimal 10) 

<msus> ::= < mass storage unit specifier > (INTemall specifies the 
front disc drive and INTemalO specifies the rear disc drive) 
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Syntax 

Diagrams 


Command 

Structure 


Common 

Commands 


Mainframe 

Commands 

Expansion Frame 
Commands 


At the beginnmg of each of the following chapters are syntax diagrams 
showing the proper syntax for each command. All characters 
contained in a circle or oblong are literals, and must be entered exactly 
as shown. Words and phrases contained in rectangles are names of 
items used with the command and are described in the accompanying 
text of each command. Each Une can only be entered from one 
direction as indicated by the arrow on tbe entry Ime. Any combination 
of commands and arguments that can be generated by following the 
lines in the proper direction is syntactically correct. An argument is 
optional if there is a path around it. When there is a rectangle which 
contains the word "space,” a white space character must be entered. 
White space is optional in many other places. 


The HP 165(X)A programming commands are divided into three types: 
common commands, m ainf rame commands, and subsystem commands. 
A programming command tree is shown in figure 4-1 and a 
programming command cross-reference is shown in table 4-2. 

The common commands are the commands defined by IEEE 4882. 
These commands control some functions that are common to all IEEE 
488.2 instruments. Sending the common commands do not take the 
instrument out of a selected subsystem. 


The mainframe commands control many of the basic functions of the 
instrument. 


When an HP 16501A Expansion frame is connected to the HP 16500A 
mainframe most of the programming is not affected and is transparent. 
The only commands affected by the presence of an HP 16501A are 
those that specify a slot number or return a slot number. These 
commands are identified in their respective descriptions. 
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SubSyStGm There are several subsystems in this instrument. Only one subsystem 
CommdndS be selected at any given time. At power on, the command parser is 
set to the root of the command tree, and therefore, no subsystem is 
selected. 


Note 


When a < program message terminator > or a leading colon (:) is sent 
in a program message, the command parser is returned to the root of 
the command tree. 


The 3 subsystems in the HP 16500A mainframe are: 

• System - controls some basic functions of the instrument. 

• Mmemory - provides access to both internal disc drives. 

• Intermodule - allows intermodule arming between multiple 
modules. 


PrOQraiii 

Examples 


The program examples given for each command in the following 
chapters and appendices were written on an HP 9000 Series 200/300 
controller using HP BASIC 5.0 language. The programs always assume 
a generic address of XXX. If a printer is used, it is always assumed to 
be connected to the non-controller interface and activated by the 
:SYSTEM:PRINT command. 


In these examples, spedal attention should be paid to the ways in which 
the command/query can be sent. The way the instrument is set up to 
respond to a command/query has no bearing on how you send the 
command/query. That is, the command/query can be sent using the 
longform or shortform if one exists for that command. You can send 
the command/query using upper case (capital) letters or lower case 
(small) letters; both work the same. Also, the data can be sent using 
almost any form you wish. If you were sending a channel 1 range value 
to the oscilloscope module of 100 mV, that value could be sent using a 
decimal (.1), or an exponential (le-1 or l.OE-1), or a suffix (100 mV or 
lOOMV). 



The contents of a string is case sensitive and must be expressed exactly 
the same each time it is used. 
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As an example, set channel 1 range of the oscilloscope module to 100 
mV by sending one of the following; 

• commands in longform and using the decimal format. 

OUTPUT XXX,-:CHANNEL1 .RANGE .I" 

• commands in shortform and using an exponential format. 
OUTPUT XXX;‘:CHAN1:RANG 1E-1‘ 

• commands using lower case letters, shortforms, and a suffix. 
OUTPUT XXX;*:chan1:rang 100 mV 


In these examples, the colon shown as the first character of the 
NotG command is optional on the HP 16500A. The space between RANGE 

and the argument is required. 


To observe the headers for queries, you must bring the returned data 
into a string variable. Generally, you should also dimension all string 
variables before reading the data. 

If you do not need to see the headers and a numeric value is returned 
from the HP 16500A, then you should use a numeric variable. In this 
case the headers should be turned off. 


The contents of strings" " are case sensitive (label names, etc.). 
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Command Set 
Organization 


The command set for the HP 16500A mainframe is divided into 5 
separate groups: Common commands, mainframe commands and 3 
sets of subsystem commands. Each of the 5 groups of commands is 
described in the foUomng chapters. Each of the chapters contain a 
brief description of the subsystem, a set of syntax diagrams for those 
commands, and finally, the commands for that subsystem in 
alphabetical order. The commands are shown in the longform and 
shortform using upper and lowercase letters. As an example SELect 
indicates that the longform of the command is SELECT and the 
shortform of the command is SEL. Each of the commands contain a 
description of the command and its arguments, the command syntax, 
and a programming example. 



Each module within the HP 16500A will include additional sets of 
subsystem commands. For a list of these subsystem commands, refer to 
the individual programming manuals for each module. 
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Table 4-2. Alphabetic Command Cross-Reference 


Command 

Where Used 

Command 

Where Used 

AUToload 

MMEMory Subsystem 

:MMEMory 

Subsystem Selector 

BEEPer 

Mainframe Command 

MSI 

MMEMory Subsystem 

CAPability? 

Mainframe Command 

•OPC 

Common Command 

CARDcage? 

Mainframe Command 

•OPT? 

Common Command 

CATalog? 

MMEMory Subsystem 

PACK 

MMEMory Subsystem 

*CLS 

Common Command 

•PRE 

Common Command 

COPY 

MMEMory Subsystem 

PRINt 

SYSTem Subsystem 

DEBug 

Mainframe Command 

PURGe 

MMEMory Subsystem 

DELete 

INTermodule Subsystem 

REName 

MMEMory Subsystem 

DOWNload 

MMEMory Subsystem 

RMODe 

Mainframe Command 

DSP 

SYSTem Subsystem 

•RST 

Common Command 

EOI 

Mainframe Command 

SELect 

Mainframe Command 

ERRor? 

SYSTem Subsystem 

SETColor 

Mainframe Command 

•ESE 

Common Command 

SETup 

SYSTem Subsystem 

•ESR? 

Common Command 

SKEW 

INTermodule Subsystem 

HEADer 

SYSTem Subsystem 

SOUNd 

Mainframe Command 

HTIMe? 

INTermodule Subsystem 

•SRE 

Common Command 

*IDN? 

Common Command 

STARt 

Mainframe Command 

INTTialize 

MMEMory Subsystem 

•STB? 

Conunon Command 

INPort 

INTermodule Subsystem 

STOP 

Mainframe Command 

INSert 

INTermodule Subsystem 

STORe 

MMEMory Subsystem 

:INTermodule 

Subsystem Selector 

:SYSTem 

Subsystem Selector 

•1ST? 

Common Command 

TREE 

INTermodule Subsystem 

LER? 

Mainframe Command 

•TRG 

Common Command 

LOAD 

MMEMory Subsystem 

•TST? 

Common Command 

LOCKout 

Mainframe Command 

TTIMe? 

INTermodule Subsystem 

LONGfonn 

SYSTem Subsystem 

UPLoad? 

MMEMory Subsystem 

MENU 

Mainframe Command 

•WAI 

Common Command 
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Common Commands 


Introduction 
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The common commands are defined by the IEEE 488^ standard. 
These commands will be common to all instruments that comply with 
this standard. 

The common commands control some of the basic instrument 
functions, such as instrument identification and reset, how status is 
read and cleared, and how commands and queries are received and 
processed by the instrument. 

Common commands can be received and processed by the HP 16500A 
whether they are sent over the bus as separate program messages or 
within other program messages. If an instrument subsystem has been 
selected and a common command is received by the instrument, the 
instrument will remain in the selected sybsystem. For example if the 
program message 

•:MMEMORY;INITIALIZE:*CLS: STORE ’FILE_’.’DESCRIPTION’" 

is received by the instrument, the instrument will initialize the disc and 
store the file; and clear the status information. This would not be the 
case if some other type of command were received within the program 
message. For example, the program message 

•;MMEMORY:INITIALIZE;:SELECT 1;:MMEMORY:STORE ’FILE_’,’DESCRIPTION’- 

would initialize the disc, select the module in slot A, then store the file. 
In this example rMMEMORY must be sent again in order to reenter 
the mmemory subs)^tem and store the file. 


Common Commands 

5-1 


Common Commands 
5-2 


Each status register has an associated status enable (mask) register. By 
setting the bits in the mask value you can select the status information 
you wish to use. Any status bits that have not been masked (enabled in 
the enable register) will not be used to report status summary 
information to bits in other status registers. 

Refer to Appendix B, "Status Reporting" for a complete discussion of 
how to read the status registers and how to use the status information 
available from this instrument. 

Refer to figure 5-1 for the common commands syntax diagram. 
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mask = An integer, 0 through 255. This number is the sum of all the bits 
in the mask corresponding to conditions that are enabled. Refer to the 
*ESE and *SRE commands for bit definitions in the enable re^sters. 

pre_mask = An integer, 0 through 65535. This number is the sum of all 
bits in the mask corresponding to conditions that are enabled. Refer to 
the *PRE command for bit definitions in the enable re^ster. 

Figure 5-1. Common Commands Syntax Diagram 
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*CLS 


*CLS 


Command Syntax: 

Example: 
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(Clear Status) Command 

The *CLS common command clears all event status registers, queues, 
and data structures, including the device defined error queue and 
status byte. If the *CLS command immediately follows a < program 
message terminator >, the output queue and the MAY (Message 
Available) bit will be cleared. 

*CLS 

OUTPUT XXX;"*CLS" 


Refer to Appendix B, "Status Reporting" for a complete discussion of 
status. 
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(Event Status Enable) 


command/query 


The *ESE command sets the Standard Event Status Enable Register 
bits. The Standard Event Status Enable Register contains a mask value 
for the bits to be enabled in the Standard Event Status Register. A one 
in the Standard Event Status Enable Register will enable the 
corresponding bit in the Standard Event Status Register which sets the 
ESB bit in the status byte. A zero will disable the bit. Refer to table 
5-1 for information about the Standard Event Status Enable Register 
bits, bit weights, and what each bit masks. 

The *ESE query returns the current contents of the enable register. 

. iic4 Refer to Appendix B, "Status Reporting" for a complete discussion of 
NOtG "W status. 

Command Syntax: *ese <mask> 

where: 

< mask >:; = 0 to 255 (integer) 

Example: output xxx;**ese 32* 

In this example, the *ESE 32 command will enable CME (Command 
Error), bit 5 of the Standard Event Status Enable Register. Therefore, 
when a command error occurs, the event summary bit (ESB) in the 
Status Byte Register will also be set. 
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Query Syntax: *ese? 


Returned Format: <mask><NL> 

Example; io dim Event$[ioo] 

20 OUTPUT XXX:“*ESE?- 
30 ENTER XXX; Events 
40 PRINT Events 
50 END 

Table 5-1. Standard Event Status Enable Register 


Bit 

Weight 

Enables 

7 

128 

PON - Power On 

6 

64 

URQ - User Request 

5 

32 

CME - Command Error 

4 

16 

EXE - Execution Error 

3 

8 

DDE - Device Dependent Error 

2 

4 

QYE - Query Error 

1 

2 

RQC - Request Control 

0 

1 

OPC - Operation Complete 


High - enables the ESR bit 
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*ESR 


*ESR (Event Status Register) C|U6ry 

The *ESR query returns the contents of the Standard Event Status 
Register. Reading the register clears the Standard Event Status 
Renter. 

Query Syntax: *ESR? 

Returned Format: < status>< nl> 
where: 

< status >;; = 0 to 255 (integer) 

Example: 10 dim Esr_event$[100] 

20 OUTPUT XXX;**ESR?" 

30 ENTER XXX;Esr_event$ 

40 PRINT Esr_event$ 

50 END 

With the example, if a command error has occurred the variable 
"Esr_event" will have bit 5 (the CME bit) set. 

Table 5-2 shows the Standard Event Status Register. The table shows 
each bit in the Standard Event Status Register, and the bit weight. 
When you read Standard Event Status Register, the value returned is 
the total bit weights of all bits that are high at the time you read the 
byte. 
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*ESR 


Table 5-2. The Standard Event Status Register 


Bit 

Bit Weight 

Bit Name 

Condition 

7 

128 

PON 

0 = register read - not in power up mode 

1 = power up 

6 

64 

URQ 

0 = user request - not used - always zero 

5 

32 

CME 

0 = no command errors 

1 = a command eror has been detected 

4 

16 

EXE 

0 = no execution errors 

1 = an execution error has been detected 

3 

8 

DDE 

0 = no device dependent error has been detected 

1 = a device dependent error has been detected 

2 

4 

QYE 

0 = no query errors 

1 = a query error has been detected 

1 

2 

RQC 

0 = request control - not used- always zero 

0 

1 

OPC 

0 = operation is not complete 

1 = operation is complete 
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*IDN 


* ID N (Identification Number) C| UGiy 

The *IDN? query allows the instrument to identify itself. It returns the 
string: 

■HEWLETT-PACKARD, 16500A,0,REV < revision code>' 

An *IDN? query must be the last query in a message. Any queries 
after the *IDN? in the program message will be ignored. 

Query Syntax: *idn? 

Returned Format: Hewlett-Packard, i6500A,o, rev < revision code> 

where: 

< revision code >:: = four digit code in the format XX.XX representing the current ROM revision 

Example: io dim id$[ioo] 

20 OUTPLIT XXX;"*IDN?" 

30 ENTER XXX;ld$ 

40 PRINT ld$ 

50 END 
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*IST 


*iST (Individual Status) C|UGry 

The •IST query allows the instrument to identify itself during parallel 
poll by allowing the controller to read the current state of the IEEE 
488.1 defined "ist” local message in the instrument. The response to 
this query is dependent upon the current status of the instrument. 

Figure 5-2 shows the *IST data structure. 

Query Syntax: *ist? 

Returned Format: <id>< nl> 

where: 

<id>::= Oor 1 

1= indicates the ‘ist* local message is false 
0:: a indicates the 'ist* local message is true 

Example: io dim Event$[ioo] 

20 OUTPUT XXX;**IST?’ 

30 ENTER XXX;Event$ 

40 PRINT Event$ 

50 End 
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LOGICAL OR 


*IST 




















*OPC 


*OPC 


Command Syntax: 
Example: 
Query Syntax: 
Returned Format: 
Example: 
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(Operation Complete) 


command/query 


The *OPC command will cause the instrument to set the operation 
complete bit in the Standard Event Status Register when all pending 
device operations have finished. The commands which affect this bit 
are the Overlapped Commands. An Overlapped Command is a 
command that allows execution of subsequent co mman ds while the 
device operations initiated by the Overlapped Command are still in 
progress. Some examples of overlapped commands for the HP 16500A 
are: 

STARt 

STOP 

Additional overlapped commands are defined in the individual 
programming manuals for each module. 

The •OPC query places an ASCII "1" in the output queue when all 
pending device operations have been completed. 

*OPC 

OUTPUT XXX;'*OPC 
*OPC? 

1<NL> 

DIM Status$[100] 

20 OUTPUT XXX;"*OPC?’ 

30 ENTER XXX: StatusS 
40 PRINT Status! 

50 END 
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*OPT 


*OPT 


(Option Identification) 


query 


The •OPT query identifies the software installed in the HP 16500A. 
This query returns nine parameters. The first parameter indicates 
whether you are in the System. The next two parameters indicate any 
software options installed, and the next parameter indicates whether 
intermodule is available for the System. The last five parameters list 
the installed software for the modules in slot A throu^ E for an HP 
16500A mainframe. When an HP 16501A Expansion frame is 
connected, there will be ten parameters after the INTERMODULE 
for modules in slots A through J. A zero in any of the last eight 
parameters indicates that the corresponding software is not currently 
installed. 

Query Syntax: *opt? 

Returned Format: {SYSTEM},{<option> ]0},{<option> |0},{INTERMODULE|0},{<module> |0}, 

{< module > |0},{<module > |0},{< module > |0},{< module > |0} 
[,{<module> |0},{<module> |0},{<module> |0},{<module> |0}, 

{< module > |0}1<NL> 

where: 

< option >:: = name of software option 
< module >:: = name of module software 



The name returned for software options and module software is the 
same name that appears in the field in the upper-left comer of the 
menu for each option or module. 


Example: io dim Option$[200] 

20 OUTPUT XXX;**OPT?' 
30 ENTER XXX;Option$ 
40 PRINT Options 
50 END 
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*PRE 


*PRE (ParaUelPoU Enable Renter Enable) COmmand/query 

The *PRE command sets the parallel poll register enable bits. The 
Parallel Poll Enable Register contains a mask value which is ANDed 
with the bits in the Status Bit Register to enable an "ist" during a 
parallel poll. The query returns the current value of the register. 

Refer to table 5-3 for the bits in the Parallel Poll Enable Register and 
what they mask. 

Command Syntax: *pre <mask> 
where: 

< pre_mask >:; = 0 to 65535 (integer) 

Example: Output xxx:“*pre 16' 

This example wll allow the HP 16500A to generate an "ist" when a 
message is available in the output queue. When a message is available, 
the MAV (Message Available) bit in the Status Byte Register will be 
high. 

Query Syntax: •*pre?" 

Returned format: < mask >< nl > 

where: 

< mask >:: = sum of all bits that are set - 0 through 65535 

Example: 10 dim Pre_value$(100] 

20 OUTPUT XXX;**PRE?' 

30 ENTER XXX;Pre_value$ 

40 PRINT Pre value$ 

50 END 
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*PRE 


Table 5-3. HP 16500A Parallel Poll Enable Register 


Bit 

Weight 

Enables 

15-8 


Not used 

7 

128 

Not used 

6 

64 

MSS - Master Summary Status 

5 

32 

ESB - Event Status 

4 

16 

MAV - Message Available 

3 

8 

LCL - Local 

2 

4 

Not used 

1 

2 

Not used 

0 

1 

MSB - Module Summary 
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*RST 


(Reset) 


command 


The *RST command (488.2) is not implemented on the HP 16500A. 
The HP 16500A will accept this command, but the command has no 
affect on the instrument. 


The *RST command is generally used to place the instrument in a 
NotG "iP predefined state. Since the HP 165{X)A allows you to store predefined 
configuration files for individual modules or the entire system, resetting 
the instrument can be accomplished by simply loading the appropriate 
configuration file. For more information, refer to the chapter 
"Mmemory Subsystem" in this manual. 
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*SRE (Service Request Enable) COmmand/qUGry 

The *SRE command sets the Service Request Enable Register bits. 

The Service Request Enable Register contains a mask value for the bits 
to be enabled in the Status Byte Register. A one in the Service 
Request Enable Register will enable the corresponding bit in the Status 
Byte Register. A zero will disable the bit. Refer to table 5-4 for the 
bits in the Service Request Enable Register and what they mask. 

The *SRE query returns the current value. 

Refer to Appendix B, "Status Reporting" for a complete discussion of 
N0t6 'Htr status. 

Command Syntax: *sre <mask> 
where: 

< mask >:: = 0 to 255 (integer) 

Example: output xxx;'-sre 16“ 

This example enables a service request to be generated when a 
message is available in the output queue. When a message is available, 
the MAV (Message Available) bit will be high. 
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*SRE 


Query Syntax: *sre? 

Returned Format: <mask> <nl> 
where: 

< mask>:: = sum of all bits that are set • 0 through 255 

Example: 10 dim Sre_value$[100] 

20 OUTPUT XXX;**SRE7’ 

30 ENTER XXX;Sre_value$ 

40 PRINT Sre value$ 

50 END 

Table 5-4. HP 16500A Service Request Enable Register 


Bit 

Weight 

Enables 

15-8 


not used 

7 

128 

not used 

6 

64 

MSS - Master Summary Status 

5 

32 

ESB - Event Status 

4 

16 

MAV - Message Available 

3 

8 

LCL- Local 

2 

4 

not used 

1 

2 

not used 

0 

1 

MSB - Module Summary 
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*STB 


*STB (Status Byte) query 

The *STB query returns the current value of the instrument’s status 
byte. The MSS (Master Summary Status) bit and not RQS (Request 
Service) bit is reported on bit 6. The MSS indicates whether or not the 
device has at least one reason for requesting service. Refer to table 5-5 
for the meaning of the bits in the status byte. 

. Ilia Refer to Appendix B, "Status Reporting" for a complete discussion of 
Note w status. 


Query Syntax: *stb? 

Returned Format: <vaiue><NL> 

where: 

< value >:: = 0 through 255 (integer) 

Example: io dim stb_vaiue$[iooi 
20 OUTPUT XXX:**STB?" 
30 ENTER XXX, Stb_value$ 
40 PRINT Stb_value$ 

50 END 
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*STB 


Table 5-5. The Status Byte Register 


Bit 

Bit Weight 

Bit Name 

Condition 

7 

128 

— 

0 = not Used 

6 

64 

MSS 

0 = instrument has no reason for service 

1 = instrument k requesting service 

5 

32 

ESB 

0 = no event status conditions have occurred 

1 = an enabled event status condition has occurred 

4 

16 

MAV 

0 = no output messages are ready 

1 = an output message k ready 

3 

8 

LCL 

0 = a remote-to-local transition has not occurred 

1 = a remote-to-local transition has occurred 

2 

4 

— 

not used 

1 

2 

— 

not used 

0 

1 

MSB 

0 = a module or the system has activity to report 

1 = no activity to report 


0 = Fake = Low 
1 = True = High 


Common Commands 
5-20 


HP 16500A/16501A 
Programming Reference 














*TRG 


*TRG 


Command Syntax: 
Example: 


(Trigger) 


command 


The *TRG command has the same effect as a Group Execute Trigger 
(GET). That effect is as if the START command had been sent for 
intermodule group run. K no modules are configured in the 
Intermodule menu, this command has no effect. 

*TRG 

OUTPUT XXX;“*TRG“ 
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*TST (Test) query 

The •TST query returns the results of the power-up self-test. The 
result of the test is a 9-bit mapped value which is placed in the output 
queue. A one in the corresponding bit means that the test failed and a 
zero in the corresponding bit means that the test passed. Refer to table 
5-6 for the meaning of the bits returned by a TST? query. 

Query Syntax: *tst? 

Returned Format: <result>< nl> 

where: 

< result >:: = 0 through 511 Onteger) 

Example: io output xxx;'*tst?" 

20 ENTER XXX;Tst_value 
30 PRINT Tst value 
40 END 
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Table 5-6. Bits Returned by *TST? Query 
(Power-Up Test Results) 


Bit 

Bit Weight 

Test 

8 

256 

Front Disk Text 

7 

128 

Rear Disk Test 

6 

64 

Touchscreen Test 

5 

32 

(not used - always zero) 

4 

16 

(not used - always zero) 

3 

8 

Display Test 

2 

4 

Interupt Test 

1 

2 

RAM Test 

0 

1 

ROM Test 
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*WAI 


*WAI 


Command Syntax: 
Example: 
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(Wait) 


command 


The * WAI command causes the device to wait until the completion of 
aU overlapped commands before executing any further commands or 
queries. overlapped command is a command that allows execution 
of subsequent commands while the device operations initiated by the 
overlapped command are still in progress. Some examples of 
overlapped commands for the HP 16500A are: 

STARt 

STOP 

Additional overlapped commands are defined in the individual 
programming manuals for each module. 

*WA1 

OUTPUT XXX:'*WAI" 
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Introduction 




Mainframe commands control the basic operation of the instrument for 
both the HP 16500A alone or with the HP 16501A connected. They 
can be called at anytime, and from any module. The only difference in 
mainframe commands with an HP 16501A connected is the number of 
slots and modules. These differences will be noted in the affected 
command descriptions. Refer to figure 6-1 for the Mainframe 
commands syntax diagram. 
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value = integer, 0 to 65535. 

module integer, -2 to 5 (HP 165WA only), or-2 to 10 (HP 1650lA connected) 

menu = integer. R^er to the indi\ndualprogramming manuals for each module and the system for 

specific menu number definitions. 

enable_value = integer, 0 to 255. 

index = integer, 0 to 5. 

color = integer, Oto 7. Color number 0 cannot he changed. 
hue = integer, 0 to 100. 
sat = integer, 0 to 100. 
lum = integer, 0 to 100. 

Figure 6-1. Mainframe Commands Syntax Diagram (Continued) 
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BEEPer 


BEEPer 


Command Syntax: 
Examples: 

Query Syntax: 

Returned Format: 

^Aaiiipic. 


command/query 

The BEEPer command sets the beeper mode, which turns the beeper 
sound of the instrument on and off. When BEEPer is sent with no 
argument, the beeper will be sounded without affecting the current 
mode. The query returns the mode currently selected. 

:BEEPer [{ON|1}|{OFF|0}] 

OUTPUT XXX,-:BEEPER" 

OUTPUT XXX,-:BEEP ON* 


:BEEPer? 


[:BEEPer] {1|0}<NL> 

1C D!M MGds$[1(}C] 

20 OUTPUT XXX;-:BEEPER?* 
30 ENTER XXX; Modes 
40 PRINT Modes 
50 END 
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CAPability query 

The CAPability query returns the HP-SL and lower level capability sets 
implemented in the device. 

Table 6-1 lists the capability sets implemented in the HP 16500A 
Query Syntax: :CAPabiiity7 

Returned Format: [:CAPabiiity] ieee488,i987,shi,ahi,T5,L4,sri,rli,ppi,dci,dti,co,E2<nl> 

Example: 10 dim Response$[100] 

20 OUTPUT XXX;";CAPABILITY7" 

30 ENTER XXX; Responses 
40 PRINT Responses 
50 END 

Table 6-1. HP 16500A Capability Sets 


Mnemonic 

Capability Name 

Implementation 

SH 

Source Handshake 

SHI 

AH 

Acceptor Handshake 

AHl 

T 

Talker (or TE - Extended Talker) 

T5 

L 

Listener (or LE - Extended Listener) 

L4 

SR 

Service Request 

SRI 

RL 

Remote Local 

RLl 

PP 

Parallel Poll 

PPl 

DC 

Device Clear 

DCl 

DT 

Device Trigger 

DTI 

C 

Any Controller 

CO 

E 

Electrical Characteristic 

E2 
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CARDcage query 

The CARDcage query returns a series of integers which identifies the 
modules that are installed in the mainframe. For an HP 165(X)A alone, 
the first five numbers returned are the card identification numbers (a 
-1 means no card is in the slot). The remaining five numbers returned 
indicate the module assignment for each card. The possible values for 
the module assignment are 0,1,2,3,4, and 5 where 0 indicates an 
empty slot or the module software is not recognized or not loaded. 

1..5 indicates the number of the slot in which the master card for this 
card is located. 

When an HP 16501A is connected, the first ten numbers returned are 
the card identification numbers (a -1 means no card is in the slot). The 
remaining ten numbers returned indicate the module assignment for 
each card. The possible values for the module assignment are 0 
through 10 where 0 indicates an empty slot or the module software is 
not recognized or not loaded. 1...10 indicates the number of the slot in 
which the master card for this card is located. 

Table 6-2 lists the card identification numbers for the first five 
parameters and their assodated cards. 

Query Syntax: : CARDcage? 

Returned Format: [: CARDcage] 

<ID>,<1D>,<ID>,<1D>,<ID>,[<ID>,<ID>,<ID>,<ID>,<1D>,] 

< assign >. < assign >, < assign >, < assign >, < assign > 

[, < assign >, < assign >, < assign >, < assign >, < assign > ] < NL > 

where: 

<ID>::= card identification number (integer) 

< assign >:: = module assignment finteger) 

Example: io dim Card$[ioo] 

20 OUTPUT XXX;*:CARDCAGE?" 

30 ENTER XXX;Card$ 

40 PRINT Cards 
50 END 
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CARDcage 


Table 6-2. Card identification Numbers 


Id Number 

Card 

31 

HP 16510A or B Logic Analyzer Card 

1 

HP 16515A1 GHz Timing Master Card 

2 

HP 16516A1 GHz Timing Expansion Card 

21 

HP 16520A Pattern Generator Master Card 

22 

HP 16521A Pattern Generator Expansion Card 

11 

HP 16530A Oscilloscope Timebase Card 

12 

HP 16531A Oscilloscope Acquisition Card 

40 

HP 16540A Logic Analyzer Card 

41 

HP 16541A Logic Analyzer Card 


Note 



Refer to the individual programming manuals for each module for 
cards not listed in table 6-2. 
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CESE (Combined Event Status Enable) COmmand/query 

The CESE command sets the Combined Event Status Enable register. 
This register is the enable register for the CESR register and contains 
the combined status of all of the MESE (Module Event Status Enable) 
registers of the HP 16500A. The query returns the current setting. 

Table 6-3 lists the bit values for the CESE register. 

Command Syntax: :CESE < value > 

where: 

< value >:: = 0 to 65535 fmteger) 

Example: output xxx.:-:CESE 32 * 

Query Syntax: :CESE? 

Returned Format: [:CESE] <value > <nl> 

Example: 

10 DIm 3etting$[100j 
20 OUTPUT XXX;*:CESE?* 

30 ENTER XXX;Setting$ 

40 PRINT Settings 
50 END 
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Table 6-3. HP 16500A Combined Event Status Enable Register 


Bit 

Weight 

Enables 

11-15 


not used 

10 

1024 

Module in slot J 

9 

512 

Module in slot I 

8 

256 

Module in slot H 

7 

128 

Module in slot G 

6 

64 

Module in slot F 

5 

32 

Module in slot E 

4 

16 

Module in slot D 

3 

8 

Module in slot C 

2 

4 

Module in slot B 

1 

2 

Module in slot A 

0 

1 

Intermodule 
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CES R (Combined Event Status Register) C|U6ry 

The CESR query returns the contents of the Combined Event Status 
register. This register contains the combined status of all of the 
MESRs (Module Event Status Registers) of the HP 16500A. Table 6-4 
lists the bit values for the CESR register. 

Query Syntax: :CESR? 

Returned Format: [:CESR] <vaiue><NL> 

where: 

<value >:: = 0 to 65535 Onteger) 

Example: lo dim Eyent$[ioo] 

20 OUTPUT X)6(;-:CESR?* 

30 ENTER XXX;Event$ 

40 PRINT Events 
50 END 
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CESR 


Table 6-4. HP 16500A Combined Event Status Register 


Bit 

Bit Weight 

Bit Name 

Condition 

11-15 



0 = not used 

10 

1024 

Module J 

0 = No new status 

1 = Status to report 

9 

512 

Module I 

0 = No new status 

1 = Status to report 

8 

256 

Module H 

0 = No new status 

1 = Status to report 

7 

128 

Module G 

0 = No new status 

1 = Status to report 

6 

64 

Module F 

0 = No new status 

1 = Status to report 

5 

32 

Module E 

0 = No new status 

1 = Status to report 

4 

16 

Module D 

0 = No new status 

1 = Status to report 

3 

8 

Module C 

0 = No new status 

1 = Status to report 

2 

4 

Module B 

0 = No new status 

1 = Status to report 

1 

2 

Module A 

0 = No new status 

1 = Status to report 

0 

1 

Intermodule 

0 = No new status 

1 = Status to report 
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EOl 


EOl (End Or Identify) command/query 

The EOl command spedfies whether or not the last byte of a reply 
from the instrument is to be sent with the EOl bus control line set true 
or not. If EOl is turned off, the box will no longer be sending 488.2 
compliant responses. The query returns the current status of EOl. 

Command Syntax: ;EOI{{ON|i}|{Off|o}} 

Example: output xxx;-:EOi on" 

Query Syntax: :EOt? 

Returned Format: [:EOi] {i | 0 }<NL> 

Example: io dim Mods$[ioo] 

20 OUTPUT XXX;':EOI?* 

30 ENTER XXX;Mode$ 

40 PRINT Modes 
50 END 
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LER 


LER 


(LCL Event Register) 


query 


The LER query allows the LCL Event Register to be read. After the 
LCL Event Register is read, it is cleared. A one indicates a 
remote-to-local transition has taken place. A zero indicates a 
remote-to-local transition has not taken place. 

Query Syntax: ;LER? 

Returned Format: [:LER] {o|i}<nl> 

Example: io dim Event$[ioo] 

20 OUTPUT XXX;MER7* 

30 ENTER XXX; Events 
40 PRINT Events 
50 END 
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LOCKout 


Command Syntax: 
Example: 
Query Syntax: 
Returned Format: 
Example: 
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command/query 

The LOCKout command locks out or restores front panel operation. 
When this function is on, all controls (except the power switch) are 
entirely locked out. The LOCKout query returns the current status of 
the LOCKout command. 

LOCKout {{ON 11} I {OFF10}} 

OUTPUT XXX;“:LOCKOUT ON" 

LOCKout? 

[LOCKout] {0|1}<NL> 

10 DIM Status$[100] 

£\j wu I ru I /wrv, i r 

30 ENTER XXX;Status$ 

40 PRINT StatusS 
50 END 
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MENU command/query 

The MENU command puts a menu on the display. The first parameter 
specifies the desired module. The optional second parameter specifies 
the desired menu in the module (defaults to 0). 

Command Syntax: :menu < module >[,< menu >] 

where: 

<module >:: = selects module or system (integer-2 to 5 for HP 16500A only), (integer -2 to 10 
with HP 16501A connected) 

< menu >;: = selects menu (integer) 

Example: output xxx;“:MENU0,r 

For the first parameter: 

0 - System/Intermodule 

1 - Module in slot A 

2 - Module in slot B 

3 - Module in slot C 

4 - Module in slot D 

5 • Module in slot E 
;6;iModuli^;jh;:^ot:^B^^^^^ 

7 - Module in slot G 

8 - Module in slot H 

9 ’ Module in slot I 

10 - Module in slot J 
-1 - Software option 1 
-2 - Software option 2 

For the System: 

MENU 0,0 - System Configuration menu 
MENU 0,1 - Rear disc menu 
MENU 0,2 - Front disc menu 
MENU 03 - Utilities menu 
MENU 0,4 - Test menu 
MENU 03 - Intermodule menu 


Only available when an 
HP 16501A is connected - 
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Note ^ 

Query Syntax: 
Returned Format: 
Example: 


Refer to the individual programming manuals for each module for 
specific menu number definitions for each module. 


The MENU query returns the current menu selection. 
:MENU? 

[:MENU] <module>,<menu><NL> 

10 DIM Response$[100] 

20 OUTPUT XXX;":MENU?" 

30 ENTER XXX;Response$ 

40 PRINT Responses 
50 END 


HP 16500A/16501A 
Programming Reference 


Mainframe Commands 

6-15 




MESE<N> 


M ESE < N > (Module Event Status Enable) COmm3nCl/C|UGry 

The MESE command sets the Module Event Status Enable register. 
This register is the enable register for the MESR register. The < N > 
index specifies the module, and the parameter specifies the enable 
value. For the HP 16500A only, the < N > index 1,..5 refers to module 
in slot A...E and 0 refers to intermodule. When an HP 16501A is 
connected, the <N> index 1...10 refers to module is slot A..J. The 
query returns the current setting. 

Refer to table 6-5 and the individual programming manuals for each 
module for information about the Module Event Status Enable register 
bits, bit weights, and what each bit masks. 

Command Syntax: :MESE<N> <enable_value> 

where: 

< N >:: = integer 0 through 5 (HP 16500A only integer), integer 0 through 10 (HP 16501A 
connected). 

< enable_value >:: = 0 through 255 Onteger) 

Example: output xxx;-:MESEi 3“ 

Query Syntax: :MESE<n>? 

Returned Forniat: [:MESE<N>] <enable_value> <NL> 

Example: io dim Event$[ioo] 

20 OUTPUT XXXj’iMESEI?" 

30 ENTER 707:Event$ 

40 PRINT Event$ 

50 END 
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Table 6-5. HP 16500A Mainframe (Intermodule) Module Event 

Status Enable Register 


Bit 

Weight 

Enables 

7 

128 

not used 

6 

84 

not used 

5 

32 

not used 

4 

16 

not used 

3 

8 

not used 

2 

4 

not used 

1 

2 

RNT - Intermodule Run Until Satisfied 

0 

1 

MC - Intermodule Measurement Complete 
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MESR<N> 


MESR < N > (Module Event Status Register) CjUOry 

The MESR query returns the contents of the Module Event Status 
register. The <N> index specifies the module. For the HP 165{X)A 
only, 1...5 refers to module in slot A...E and 0 refers to intermodule. 
When an HP 16501A is connected, the < N > index 1...10 refers to 
module is slot A.. J 

Refer to table 6-6 and the individual programming manuals for each 
module for information about the Module Event Status Register bits 
and their bit weights. 

Query Syntax: :MESR<n>? 

Returned Format: [:MESR<N>] <enable_value><NL> 

where: 

< N >:: = integer 0 through 5 (HP 16500A only integer), integer 0 through 10 (HP 16501A 
connected). 

< enable_value >:; = 0 through 255 (integer) 

Example: io dim Even^[ioo] 

20 OUTPUT XXX;‘:MESR1?‘' 

30 ENTER XXX;Event$ 

40 PRINT Events 
50 END 
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Table &-6. HP 16500A Mainframe Module Event Status Register 


Bit 

Bit Weight 

Bit Name 

Condition 

7 

128 


0 = not used 

6 

64 


0 = not used 

5 

32 


0 = not used 

4 

16 


0 = not used 

3 

8 


0 = not used 

2 

4 


0 = not used 

1 

2 

RNT 

0 = Intermodule Run until not satisfied 

1 = Intermodule Run until satisfied 

0 

1 

MC 

0 = Intermodule Measurement not satisfied 

1 = Intermodule Measurement satisfied 
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RMODe 


RMODe 



Command Syntax: 
Example: 
Query Syntax: 

Returned Format: 
Example: 
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command/query 

The RMODe command spedfies the run mode for the selected module 
(or Intermodule). The query retinns the current setting. If the 
selected module is in the intermodule configuration, then the 
"intermodule" run mode will be set by this command. 


After specifying the run mode, use the STARt command to start the 
acquisition. 


:RMODe {SINGIe|REPetitive} 
OUTPUT XXX;":RMODE SINGLE* 
:RMODe7 

[:RMODe] {SINGIe |REPetitive}< NL> 

10 DIM Mode$[100] 

20 OUTPUT XXX;*: RMODE?’ 

30 ENTER XXX; Modes 
40 PRINT Modes 
50 END 
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SELect command/query 

The SELect command selects which module (or system) will have 
parser control. The appropriate module (or system) must be selected 
before any module (or system) specific commands can be sent. 

SELECT 0 selects System, SELECT 1 through 5 selects modules A 
through E in an HP 16500A only. SELECT 1 through 10 selects 
modules A through J when an HP 16501A is connected. -1 and -2 
selects software options 1 and 2 respectively. The query returns the 
current module selection. 

Figure 6-2 shows the command tree for the SELect command, 
lid SELect defaults to System (0) at power up. 

Note w - 

Command Syntax: -.SELect < module > 
where: 

<module>:: = integer -2 through 5 (HP 16500Aonly), integer -2 through 10 (HP 16501A 
connected). 

Example: output xxx,-:SELect O" 

Query Syntax: :SELect? 

Returned Format: [rSELect] <module>< nl> 

Example: io dim Moduie$[ioo] 

20 OUTPUT XXX;-:SELECT?" 

30 ENTER XXX;Module$ 

40 PRINT Modules 
50 END 
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SELect 


Only available when an 
HP 16501A is connected 


: SELECT 

-0- (SELECTS SYSTEM/INTERMOOULE) 

-1- (SELECTS MODULE IN SLOT A) 

-2- (SELECTS MODULE IN SLOT B) 

-3- (SELECTS MODULE IN SLOT C) 

-4- (SELECTS MODULE IN SLOT D) 

-5- (SELECTS MODULE IN SLOT E) 

il-c-TSEteCtS MDOULE $Lat El 

MObutc m $iot oi 

-e-^SEtfCTS ME^fULE 3W SLCfT Hl^ 

^- (SEtECTS MODULE SLOT II 

-to-^SELECTS MODULE SLOT 4i 

-1- (SELECTS OPTION 1) 

-2- (SELECTS OPTION 2) 

i«sooe47 


Figure 6-2. Select Command Tree 


Note 


When a module is selected, the parser recognizes the module’s 
commands and the System/Intermodule commands. When SELECT 0 
is used, only the System/Intermodule commands are recognized by the 
parser. 
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SETColor command/query 

The SETColor command is used to change one of the color selections 
on the CRT, or to return to the default screen colors. Four parameters 
are sent with the command to change a color: 

• Color Number (first parameter), 

• Hue (second parameter), 

• Saturation (third parameter), and 

• Luminosity (last parameter). 

Command Syntax: :SETCk)lor{<color>,<hue>,<sat>,<lum>|DEFault} 
where: 

< color >:: = 0 to 7 finteger) 

<hue>;:= Oto 100 (integer) 

< sat >;: = 0 to 100 finteger) 

< lum >:: = 0 to 100 (integer) 

ll^ Color Number 0 cannot be changed. 

Note w -- 

Example: output XXX,*: SETCOLOR 3,60, i oo, bo- 
output XXX;-:SETC DEFAULT" 

The SETColor query returns the hue, saturation, and luminosity values 
for a specified color. 

Query Syntax: rSETCoior? < color> 

Returned Format; [;SETColor] <color>,<hue>,<sat>,<lum><NL> 

Example: io dim Coior$[iooi 

20 OUTPUT XXX;-;SETCOLOR? 3* 

30 ENTER X)0(;Co!or$ 

40 PRINT Color$ 

50 END 
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STARt 


STARt 


Note ^ 


Command Syntax: 
Example: 


command 

The STARt command starts the selected module (or Intermodule) 
running in the specified run mode (see RMODe). If the specified 
module is in the Intermodule configuration, then the "Intermodule" run 
will be started. 


The STARt command is an Overlapped Command. An Overlapped 
Command is a command that allows execution of subsequent 
commands while the device operations initiated by the Overlapped 
Command are still in progress. For more information, refer to the 
•OPC and ‘WAI commands in the chapter "Common Commands." 


:STARt 

OUTPUT XXX;*:STARr 
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STOP 

Note ^ 


Command Syntax: 
Example: 
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command 

The STOP command stops the selected module (or Intermodule). If 
the specified module is in the Intermodule configmation, then the 
"Intermodule" run will be stopped. 


The STOP command is an Overlapped Command. An Overlapped 
Command is a command that allows execution of subsequent 
commands while the device operations initiated by the Overlapped 
Command are still in progress. For more information, refer to the 
*OPC and *WAI commands in the chapter "Common Commands." 


:STOP 

OUTPUT XXX;*:STOP" 
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I I ^lll i^uuoyoii^lll 

Introduction SYSTem subsystem commands control functions that are common to 

all modules, including formatting query responses and enabling reading 
and writing to the advisory line of the instrument. Refer to figure 7-1 
for the System Subsystem commands syntax diagram. 



Figure 7-1. System Subsystem Commands Syntax Diagram 
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block_data = data in IEEE 488.2 4^ format. 
string = string of up to 68 alphanumeric characters. 


Figure 7-1. System Subsystem Commands Syntax Diagram (Continued) 
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DATA 


DATA command/query 

The DATA command transmits the data part of the setup 
configuration of the selected module in block data format. The DATA 
query returns the current contents of the acquisition buffer from the 
selected module to the controller. 

. dia The DATA command is only used in conjunction with modules that are 
Note w loaded in the mainframe. The System does not contain any acquired 
data. 

Command Syntax: :SYSTem:DATA <block data in # format > 

Query Syntax: :SYSTem:DATA? 

Returned Format: [:SYSTem:DATA] < block data in # format >< NL> 

Definition of Block data in the # format is made up of a block length specifier and a 
BiOCk Deta variable number of sections. 

< block length specifier > < section 1 > < section 2> 

The block length specifier is defined as follows: 

#8 < length > 

where: 

< length >:: = the total length of all sections in byte format (must be represented with 8 digits) 
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For example, if the total length of the block (all the sections) is 144 
bytes, the block length specifier would be "#8(XXXX)144" since the 
length must be represented with 8 digits. 

Sections consist of a section header followed by the section data as 
follows: 

< section header > < section data> 


where: 


< section header >:: = 10 bytes for the section name 
1 byte reserved (always 0) 

1 byte for the module ID number (see table 7-1) 

4 bytes for the length of the section data in bytes 

The section data format varies for each section and may be any length. 


Note 4^ 


The total length of a section is 16 (for the section header) plus the 
length of the section data. Thus, when calculating the length of a block 
of configuration data, care should be taken to not forget to add the 
length of the section headers. 


HP-IB Example: io dim Biock$[32000] 

20 DIM Specifier$[2] 

30 OUTPUT XXX;':EOI ON' 

40 OUTPUT XXX;':SYSTEM:HEADOFP 
50 OUTPUT XXX;':SELECT 4- 
60 OUTPUT XXX;':SYSTEMiDATA?" 

70 ENTER XXX USING '#.2A';Specifier$ 
80 ENTER XXX USING '#,8D';Blocklength 
90 ENTER XXX USING'-K';Block$ 

100 END 


{allocate enough memory for block data 


Iselect module 
{send data query 
tread in #8 
Iread in block length 
Iread in data 


System Subsystem 
7-4 


HP 16500A/16501A 
Programming Reference 



DATA 


Table 7-1. Card identification Numbers 


ID number 

Card 

31 

HP 16510A or B Logic Analyzer Card 

1 

HP 16515A1 GHz Timing Master Card 

2 

HP 16516A1 GHz Timing Expansion Card 

21 

HP 16520A Pattern Generator Master Card 

22 

HP 16515A Pattern Generator Expansion Card 

11 

HP 16530A Oscilloscope Timebase Card 

12 

HP 16531A Oscilloscope Acquisition Card 

40 

HP 16540A Logic Analyzer Card 

41 

HP 16541A Logic Analyzer Card 
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DSP (Display) Command 

The DSP command writes the specified quoted string to a device 
dependent portion of the instrument display. 

Command Syntax: :SYSTem:DSP <string > 

where: 

<string >;; = string of up to 68 alphanumeric characters 
Example: output XXX;’:SYSTEM:DSP The message goes here’" 
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ERRor query 

The ERRor query returns the oldest error from the error queue. The 
optional parameter determines whether the error string should be 
returned along with the error number. If no parameter is received, or 
if the parameter is NUM, then only the error number is returned. If 
the value of the parameter is STRing, then the error should be returned 
in the following form: 

< error number >, < error message (string) > 

A complete list of error messages for the HP 16500A mainframe is 
shown in appendbt C. If no errors are present in the error queue, a 
zero (No Error) is returned. 

Query Syntax: :SYSTem:ERRor? [NUMeric|STRing] 

Returned Formats: Numeric: 

[:SYSTem:ERRor] <errornumber><NL> 

String: 

[:SYSTem:ERRor] <error number>,<string> <NL> 

where: 

< error number >;:= integer 

Examples: Numeric: 

10 OUTPUT XXX;-:SYSTEM:ERROR?‘ 

20 ENTER XXX; Numeric 
30 PRINT Numeric 
40 END 

String: 

10 DIM String$[100] 

20 OUTPUT XXX;‘:SYST;ERR? STRING' 

30 ENTER XXX;Strlng$ 

40 PRINT Strings 
50 END 
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HEADer command/query 

The HEADer command tells the instrument whether or not to output a 
header for query responses. When HEADer is set to ON, query 
responses will include the command header. 

The HEADer query returns the current state of the HEADer 
command. 


Command Syntax: 

Example: 
Query Command: 
Returned Format: 


:SYSTem: HEADer {{ON|1}|{OFF|0}} 
OUTPUT XXX,‘:SYSTEM:HEADER ON" 
;SYSTem;HEADer? 

[:SYSTem:HEADer] {1 |0}<NL> 


Example: io dim Mocie$[ioo] 

20 OUTPUT XXX;":SYSTEM:HEADER?" 
30 ENTER XXX:Mode$ 

40 PRINT Modes 
50 END 


Note 



Headers should be turned off when returning values to numeric 
variables. 
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LONGform 


Command Syntax: 
Example; 
Query Syntax: 

Returned Format: 
Example; 


command/query 

The LONGform command sets the longform variable which tells the 
instrument how to format query responses. If the LONGform 
command is set to OFF, command headers and alpha argiunents are 
sent from the instrument in the abbreviated form. If the the 
LONGform command is set to ON, the whole word will be output. 

This command has no affect on the input data messages to the 
instrument. Headers and arguments may be input in either the 
longform or shortform regardless of how the LONGform command is 
set. The query returns the status of the LONGform command. 

:SYSTem:LONGform {{ON 11} | {OFF10}} 

OUTPUT XXX;-;SYSTEM:LONGFORM ON’ 

:SYSTem;LONGform? 

[:SYSTem:LONGform] {1 |0}<NL> 

10 DIM Mode$[1(X}] 

20 OUTPUT XXX;’:SYSTEM:LONGFORM?" 

30 ENTER XXX; Modes 
40 PRINT Modes 
50 END 
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PRINt 



Command Syntax: 
Example: 
Query Syntax: 



HP-IB Example: 
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command/query 

The PRINt command initiates a print of the screen or listing buffer 
over the current PRINTER communication interface. The query sends 
the screen or listing buffer data over the current CONTROLLER 
communication interface. 


The print query should NOT be sent in conjunction with any other 
command or query on the same command line. 

The print query never returns a header. Also, since response data from 
a print query may be sent directly to a printer without modification, the 
data is not returned in block mode. 


:SYSTem;PRINt {SCFteen|ALL} 

OUTPUT XXX;-:SYSTEM:PRINT SCREEN" 
SYSTem:PRINt7 {SCReenjALL} 


PRINT? ALL is only available in menus that have the "Print All" option 
available on the front panel. For more information, refer to the 
individual front-panel manuals for each module. 


10 OUTPUT 707:":SYSTEM:PRINT? SCREEN" 

20SEND7:UNT UNL 

30SEND7:USTEN1 

40 SEND 7:TALK7 

50 SEND 7; DATA Idrop ATN line 

60 PRINT "WATTING FOR PRINT" 

70 END 
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SETup command/query 

The SETup command configures the selected module (or System) as 
defined by the block of data sent by the controller. The query returns a 
block of data that contains the current configuration for the selected 
module (or System) to the controller. 

Command Syntax: :SYSTem:SETup <block data in # format> 

Query Syntax: :SYSTem:SETup? 

Returned Format; [:SYSTem:SETup] <block data in # format> < NL> 

Dsfinition of Block data in the # format is made up of a block length spedfier and a 
Block Data variable number of sections. 

< block length specifier > < section 1 > < section 2> 

The block length spedfier is defined as follows: 

#8 < length > 

where: 

< length >:: = the total length of all sections in byte format (must be represented with 8 digits) 


For example, if the total length of the block (all the sections) is 144 
bytes, the block length spedfier would be "#800000144" since the 
length must be represented with 8 digits. 

Sections consist of a section header followed by the section data as 
follows: 

<s8ction header> <8ection data> 

where: 

<section header >:: = lO bytes for the section name 
1 byte reserved (always 0) 

1 byte for the module ID number (see table 7-2) 

4 bytes for the length of the section data in bytes 
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The section data format varies for each section and may be any length. 

..... Ilia The total length of a section is 16 (for the section header) plus the 
NOtG length of the section data. Thus, when calculating the length of a block 

of configuration setup data, care should be taken to not forget to add 
the length of the section headers. 

HP-IB Example: 10 dim Block$[32000] lallocate enough memory for block data 

20 DIM Specifier$[2] 

30 DIM Blocklength$[8] 

40 OUTPUT XXX;“:EOI ON" 

50 OUTPUT XXX;-:SYSTEM:HEADOFP 
60 OUTPUT XXX:*:SELECT 0* Iselect System 

70 OUTPUT XXX;":SYSTEM:SETUP?" Isend setup query 

80 ENTER XXX USING "#,2A";Specifiers Iread in #8 

90 ENTER XXX USING ‘#,8A";Blocklength$ Iread in block length 

100 ENTER XXX USING '>K":Block$ Iread in data 

110 Blocklength = IVAL(Blockiength$,10) {convert block string to integer 
2001 

210 I Send setup back to the HP 16500A 
220 ! 

230 OUTPUT XXX USING •#,14A":":SYSTEM:SETUP" 

240 OUTPUT XXX USING •#,2A";Specifier$ 

250 OUTPUT XXX USING ■#,8A";Blocklength$ 

260 OUTPUT XXX USING •■&VAL$(Blocklength)&*A";Block$ 

300 END 
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Table 7-2. Card identification Numbers 


ID Number 

Card 

31 

HP 16510A or B Logic Analyzer Card 

1 

HP 16515A1 GHz Timing Master Card 

2 

HP 16516AI GHz Timing Expansion Card 

21 

HP 16520A Pattern Generator Master Card 

22 

HP 16521A Pattern Generator Expansion Card 

11 

HP 16530A Oscilloscope Timebase Card 

12 

HP 16531A Oscilloscope Acquisition Card 

40 

HP 16540A Logic Analyzer Card 

41 

HP 16541A Lo^c Analyzer Card 
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MMEMory Subsystem 


I ntrodUCtiOn MMEMory (mass memory) subsystem commands provide access to 

both internal disc drives. Refer to figure 8-1 for the MMEMory 
Subsystem commands syntax diagram. 


Note 



< msus > refers to the mass storage unit specifier. INTemall specifies 
the front disc drive and INTemalO specifies the rear disc drive. 


If you are not going to store information to the configuration disc, or if 
the disc you are using contains information you need, it is advisable to 
write protect your disc. This will protect the contents of the disc from 
accidental damage due to incorrect commands, etc. 



Figure 8-1. Mmemory Subsystem Commands Syntax Diagram 
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Figure 8>1. Mmemory Subsystem Commands Syntax Diagram (Continued) 
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auto_file = string of up to 10 alphanumeric characters. 

msus = INTemall\INTemalO 

name = string of up to 10 alphanumeric characters. 

description = string of up to 32 alphanumeric characters. 

type = integer, refer to table 8-1. 

block_data = data in IEEE 488.2 format. 

ia_name = string of up to 10 alphanumeric characters. 

new_name = string of up to 10 alphanumeric characters. 

module = integer, ItoS (HP 16500A only), or 1 to 10 (HP 16501A connected). 

Figure 8-1. Mmemory Subsystem Commands Syntax Diagram (Continued) 
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AUToload 


AUToload command/query 

The AUToload command controls the autoload feature which 
designates a set of configuration files to be loaded automatically the 
next time the instrument is turned on. The OFF parameter (or 0) 
disables the autoload feature. A string parameter maybe specified 
instead to represent the desired autoload file. If the file is on the 
current < msus >, the autoload feature is enabled to the specified Hie. 

The AUToload query returns 0 if the autoload feature is disabled. If 
the autoload feature is enabled, the query returns a string parameter 
that specifies the current autoload file. The appropriate slot designator 
"_X" is included in the filename. "X" refers to the slot designator A...E 
for the corresponding module for an HP 165(X)A alone. When an HP 
16501A is connected "X" refers to slot designator A.. J. If the slot 
designator isthe file is for all modules. 

Command Syntax: :MMEMory:AUToload {{OFFjO} I{<auto_file>}}[,<msus>] 
where: 

<auto_file >:: = string of up to 10 alphanumeric characters 
<msus>:;= {INTemall |INTemalO} 

Examples: output XXX;':MMEM0RY:AUT0L0AD OFP 

OUTPUT XXX;":MMEMORY:AUTOLOAD ’RLEI A” 

OUTPUT XXX;":MMEMORY;AUTOLOAD ’RLE2_ J.INTERNALI" 

Query Command: :MMEMory:AUToload? 

Returned Format: [:MMEMory:AUToload] {0| <auto_file>},<msus> <NL> 

Example: 10 dim Auto status$[100] 

20 OUTPUT XXX;*:MMEMORY:AUTOLOAD?’ 

30 ENTER XXX;Auto_status$ 

40 PRINT Auto status$ 

50 END 
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CATalog query 

The CATalog query returns the directory of the currently selected disc 
in block data format. The directory consists of a 51 character string for 
each file on the disc. Each file entry is formatted as follows: 

■NNNNNNNNNN TTTTTTT DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD" 

where N is the filename, T is the file type (a number), and D is the file 
descriptor. If the < msus > is not specified, the last disc drive specified 
by the MSI command will be used. 

For more information on block data format, refer to the section 
"Definite-Length Block Response Data" in the chapter 1. 

Query Syntax: iMMEMoryiCATalog? [<msus>] 

where: 

< msus >:; = {INTernall | INTemalO} 

Returned Format: [:MMEMory:CATaIog] < block data > 
where: 

<block data>::= <filename> <fiietype> <file description>... 

Example: io DiMFiie$[5i] 

20 DIM specifier$[2] 

30 OUTPUT XXX;*:SYSTEM:HEAD OFF 

40 OUTPUT XXX;*:MMEMORY:CATALOG? INTERNALrisend catalog query 
50 ENTER XXX USING ■#,2A";Specifier$ Iread in #8 

60 ENTER XXX USING *#,8D"; Length Iread in length 

70 FOR I = 1 TO Length STEP 51 Iread and print each 

Ifile in the directory 

80 ENTER XXX USING "#,51 A*:File$ 

90 PRINT Rle$ 

100 NEXT I 

110 ENTER XXX USING "A"; Specifiers iread in final line feed 

120 END 
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COPY command 

The COPY command copies one file to a new file or an entire disc’s 
contents to another disc. The two < name > parameters are the 
filenames. The first pair of parameters specifies the source file. The 
second pair specifies the destination file. An error is generated if the 
source file doesn’t exist, or if the destination file already exists. 

If the filename is not specified for both the source and destination, then 
the entire contents of the source are transferred to the destination 
(same as the Duplicate Disc fi’ont panel operation). The previous 
contents of the destination media are destroyed. 

If the < msus > is not spedfied, the last disc drive specified by the MSI 
command will be used. 

Conriniand Syntax: :MMEMory:COPY [< name >][,<msus >],[< name >][,< msus >] 
where: 

< name >;; = string of up to 10 alphanumeric characters 
<msus>::= {INTemall |INTernalO} 

Examples: To copy the contents of "FILEl" to "FILE2'' when both files are on a 
disc on the last disc drive spedfied by the MSI command; 

OUTPUT XXX;*:MMEMORY:COPY *RLE1’,*RLE2*' 

To copy the contents of "FILEl" on the rear disc drive to "nLE2" on 
the front disc drive: 

OUTPUT XXX;*:MMEM:COPY ’RLE1\INrrERNAL0,’RLE2’.INTERNALr 

To copy the contents of "FILEl" on the last disc drive specified by the 
MSI command to "FILE2" on the rear disc drive: 

OUTPUT XXX;-:MMEMORY:COPY ’RLE1’.’RLE2MNTERNAL0" 

To duplicate the contents of the disc in the rear disc drive to a disc in 
the front disc drive: 

OUTPUT XXX;":MMEM:COPY INTERNALO.INTERNALr 
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DOWNIoad command 

The DOWNIoad command downloads a file to the specified mass 
storage device. The < name > parameter specifies the filename, the 

< description > parameter specifies the file descriptor, and the 

< block_data > contains the contents of the file to be downloaded. 

If the < msus > is not spedfied, the last disc drive specified by the MSI 
command will be used. 

Table 8-1 lists the file types for the < type > parameter. 

Command Syntax: :MMEMory:DOWNIoad < name > [, < msus > ], 

< description >, <type >, < block_data > 

where: 

< name >:: = string of up to 10 alphanumeric characters 
<msus>::= {lNTernal0)|INTemal1} 

< description >= string of up to 32 alphanumeric characters 

<type >:: = integer (see ts^le 8-1) 

< block_data >- contents of file in block data format 

Example: output XXX;*:MMEM0RY:D0WNL0AD ’SETUP_’,INTERNAL0.’RLE created 
FROM SETUP QUERY’.-16127,#800000643...' 
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Table 8-1. File Types 


File 

Filel^pe 

HP 16500A System Software 

-16128 

HP 16500A Mainframe (System) Configuration 

-16127 

HP 16510A or B Logic Analyzer Configuration 

-16096 

HP 16515A1 GHz Timing Configuration 

-16126 

HP 16520A Pattern Generator Configuration 

-16106 

HP 16530A Oscilloscope Configuration 

-16116 

HP 16540A Logic Analyzer Configuration 

-16087 

HP 16541A Logic Analyzer Configuration 

-16086 

Autoload Hie 

-15615 

Inverse Assembler 

-15614 

Option Software 

-15613 

Calibration Factors 

-15611 

Text (Generic) Type 

-15610 
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IN ITialize command 

The INITialize command formats the specified disc. If no disc drive is 
specified, then the initialize command will format the disc in the 
currently selected disc drive. 

Command Syntax: :MMEMory:INmaiize[<msus>] 

where: 

<msus>::= {INTernalO|INTernal1} 

Examples: output XXX;':MMEMORY:INmAlJ2E" 

OUTPUT XXX;":MMEMORY:INITIALIZE INTERNALO" 


nuie 


m 


Once executed, the initialize command formats the specified disc, 
permanently erasing all existing information from the disc. After that, 
there is no way to retrieve the original information. 
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LOAD [rCONFig] command 

The LXDAD co mm and loads a configuration file from the disc into 
modules, software options, or the system. The < name > parameter 
specifies the filename from the spedfied mass storage device. The 
optional < module > parameter specifies which module(s) to load the 
file into. The accepted values are 0 for system, 1...5 for the module in 
slot A...E respectively for an HP 165(X)A alone, and -1, -2 for software 
options 1 and 2 respectively. When an HP 16501A is connected, the 
accepted values are 0 for system, 1...10 for the module in slot A.. J 
respectively, and -1, -2 for software options 1 and 2. Not specifying the 
< module > parameter is equivalent to performing a ’LXDAD ALL’ 
from the front panel which loads the appropriate file for every installed 
module, software option, and for the system. 

Command Syntax: :MMEMory:LOAD[:CONfig] < name > [, < msus > ][, < module > ] 
where: 

< name >:: = string of up to 10 alphanumeric characters 
<msus>::= {INTemal0|INTernal1} 

< module >:: = integer, -2 through 5 (HP 16500A alone), or -2 through 10 (HP 16501A 
connected) 

Examples: output XXX;":MMEM0RY:L0AD:C0NRG •FILE_- 
OUTPUT XXX,‘:MMEMORY:LOAD •RLE_’,0‘ 

OUTPUT XXX;’:MMEM:LOAD:CONRG ’RLE_AMNTERNAL1,r 
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LOAD :iASSembier Command 

This variation of the LOAD command allows inverse assembler files to 
be loaded into a module that performs state analysis. The 
<IA_name> parameter specifies the inverse assembler filename from 
the desired < msus >. The parameter after the optional < msus > 
specifies which machine to load the inverse assembler into. 

The optional < module > parameter is used to specify which slot the 
state analysis module is in. 1...5 refers to the module in slot A...E for an 
HP 16500A alone. When an HP 16501A is connected, 1...10 refers to 
module A.. J. If this parameter is not specified, the state analysis 
module closest to slot A is selected. 

Oornmand Syntax: :MMEMory:LOAD:IASSembler <IA_name>[,<msus> 1,{1 j2}[,<modulo] 
where: 

< IA_name >:: = string of up to 10 alphanumeric characters 
<msus>::= {INTernalOlINTemall} 

< module >::= integer, 1 through 5 (HP 16500Aonly), or 1 through 10 (HP 16501A connected) 

Examples: output XXX;-;MMEM0RY:L0AD:IASSEMBLER ’l 68020 JP’,r 
OUTPUT XXX;-:MMEM:LOAD:IASS *I68020JP’,1NTERNAL1,1,2* 
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MSI (Mass Storage Is) command/query 

The MSI command selects a default mass storage device. If the 
parameter is omitted, the default mass storage device (front disc drive) 
is selected. The query returns the current MSI setting. 

Command Syntax: :MMEMory:MSI[<msus>] 

where: 

<msus>::= {INTemalO|INTemal1} 

Examples: output XXX;-:MMEM0RY;MSI* 

OUTPUT XXX;*;MMEM:MSI INTERNAL1‘ 

Query Syntax: ;MMEMory:MSi? 

Returned Format: [:MMEMory:MSi] <msus> <nl> 

Example: io dim Device$[ioo] 

20 OUTPUT XXX;‘:MMEMORY:MSI?* 

30 ENTER XXX; Devices 
40 PRINT Devices 
50 END 
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PACK command 

The PACK command packs the files on a disc on the specified mass 
storage device. If no disc drive is specified, this command will pack the 
disc in the last disc drive specified by the MSI command. 


Command Syntax: :MMEMory:PACK[<msus>] 
where: 

<msus>::= {INTernalOlINTernall} 

Examples: output XXX;*:MMEM0RY:PACK- 

OUTPUT XXX;":MMEM:PACK INTERNALI" 
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PURGe command 

The PURGe command deletes a file from the specified mass storage 
device. The ’< name > parameter specifies the filename to be deleted. 

Command Syntax: :MMEMory:PURGe <name>[,<msus>] 

where: 

< name >:; = string of up to 10 alphanumeric characters 
<msus>::= {INTernal0|INTernai1} 

Examples; output XXX;-:MMEM0RY:PURGE ’RLEI- 

OUTPUTXXX;*:MMEM:PURG ’RLEf.INTERNALO" 


. ilSa Once executed, the purge command permanently erases all the existing 
NOtO ’W information from the specified file. After that, there is no way to 
retrieve the original information. 
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REName command 

The REName command renames a file firom the specified mass storage 
device. The <name > parameter specifies the filename to be changed 
and the < new_name > parameter specifies the new filename. 

lisl You cannot rename a file to an already existing filename. 

Note mf - 

Command Syntax: :MMEMory:REName <name > [, < msus> ], < new_name > 
where: 

< name >;: = string of up to 10 alphanumeric characters 
<msus>::= {INTernalOIlNTemall} 

< new_name >:; = string of up to 10 alphanumeric characters 

Examples: output XXX;-:MMEM0RY:RENAME ’OLDRLE’.’NEWFILE- 

OUTPUT XXX;*:MMEM:REN ’OLDRLEMNTERNALI.’NEWRLE’* 
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STORe [:CONFig] command 

The STORe command stores module or system configurations onto a 
disc. The [:CONFig] specifier is optional and has no effect on the 
command. The < name > parameter specifies the file on the specified 
mass storage device. The < description > parameter describes the 
contents of the file. The optional < module > parameter allows you to 
store the configuration for a spedfic module or modules. 1...5 refers to 
the module in slot A...E in an HP 16500A or 1...10 refers to module in 
slot A.. J when an HP 16501A is connected. 0 refers to the system. -1 
and >2 are for software options. 

If the optional < module > parameter is not specified, the 
configurations for all of the modules are stored. 

Commanci Syntax: :MMEK^ry:STORe [:CONfig] <name >[,<msus>],<description >[,<module >] 

where; 

< name >:: = string of up to 10 alphanumeric characters 

<msus>::= {INTemal0|INTemal1} 

< description >:: = string of up to 32 alphanumeric characters 

< module >:: == integer, -2 through 5 (HP 16500A only), or -2 through 10 (HP 16501A 
connected)) 

Examples: output XXX,-:MMEM:ST0R *DEFAULTS’,’SETUPS for all modules- 
OUTPUT XXX;-:MMEMORY:STORE;CONRG ’SCOPE’,INTERNAL1 .'SLOT B 
SCOPE CONRG’,2* 

* iSi The appropriate slot designator "_X" is added to all files when they are 
Note W stored. "X" refers to the letter A...E of the corresponding slot for each 
module in an HP 165()0A alone or A.. J when an HP 16501A is 
connected. 
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UPLoad query 

The UPLoad query uploads a file. The < name > parameter specifies 
the file to be uploaded from the specified mass storage device. The 
contents of the file are sent out of the instrument in block data form. 


■isl This command should only be used for HP 165XX or HP 165X files. 

Note W - 


Query Syntax: :MMEMory:UPLoad? < name > [, <msus> ] 
where: 

< name >:: = string of up to 10 alphanumeric characters 
<msus>:;= {INTemal0|INTemaI1} 


Returned Format: [:MMEMory;UPLoad] <block_data><NL> 

HP-iB Example: 10 dim Block$[32000] lallocate enough memory for block data 

20 DIM Specifier$[2] 

30 OUTPUT XXX;‘:EO! ON" 

40 OUTPUT XXX;";SYSTEM HEAD OFP 

50 OUTPUT XXX;":MMEMORY:UPLOAD? ’RLEI’.INTERNALI" Isend upload query 
60 ENTER XXX USING "#.2A-;Specifier$ Iread in #8 

70 ENTER XXX USING "#,8D";LBngth Iread in block length 

80 ENTER XXX USING "-K";Block$ Iread in file 

90 END 
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IntrodUCtion INTermodule subs>«tem commands specify intermodule arming 

between multiple modules. Refer to figure 9-1 for the INTermodule 
Subsystem commands syntax diagram. 



Figure 9-1. Intermodule Subsystem Commands Syntax Diagram 
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1«Mt/5X«6 

module = integer, 1 to 5 (HP 165(H1A alone), or 1 to 10 (HP 1650lA connected). 
index = integer, 1 to 5 (HP 16500A alone), or 1 to 10 (HP 16501A connected). 
setting = numeric, -1.0 to 1.0 in seconds. 

Figure 9-1. intermodule Subsystem Commands Syntax Diagram (Continued) 
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DELete 


DELete 


Command Syntax: 

where: 
< module 

Example: 
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command 

The DELete command is used to delete a module, group of modules, 
PORT OUT, or an entire intermodule tree. The < module > 
parameter sent with the delete command refers to the slot location of 
the module (1...5 modules in slots A...E for the HP 16500A alone or 
1...10 modules in slots A.. J when an HP 16501A is connected). 

:INTermodule:DELete {ALL | OUT | < module >} 


::= integer, 1 through 5 (HP 16500Aonly), integer 1 through 10 (HP 16501A 
connected) 

OUTPUT XXX,-:INTERMODULE:DELETE ALL" 

OUTPUT XXX;":INT:DEL 2* 
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HTIMe query 

The HTIMe query returns five values (HP 165(X)A alone) representing 
the internal hardware skew for all of the modules in the Intermodule 
configuration. When an HP 16501A is connected, the HTIMe query 
returns 10 values. The first value is the skew for the module in slot A, 
the second value is for the module in slot B, the third value is for slot C, 
etc. If there is no internal skew, 9.9E37 is returned. 


... The internal hardware skew is only a display adjustment for time 

Not6 ^Ir correlated waveforms. The values returned are the average 

propagation delays of the trigger lines through the intermodule bus 
circuitry for each module. These values are for reference only because 
the values returned by l l lMe include the internal hardware skew 
represented by HTIMe. 


Query Syntax: :INTermodule;HTIMe? 

Returned Format: [rlNTermodulerHTIMe] 

< vsJue_1 >, < value_2 >, < value_3 >, < value_4 >, < value_5 > 

[, < value_6 >, < value_7 >, < vaiue_8 >, < value_9 >, < value_10 > ] < NL > 

where: 

<value_1 >:: = skew for module in slot A (real number) 

< value_2 >:; = skew for module in slot B (real number) 

< valuers >:: = skew for module in slot C (real number) 

<value_4>« skew for module in slot D (real number) 

<value_5>:: skew for module in slot E (real number) 

<value_6>:: = skew for module in slot F (real number) 

<value_7>:: = skew for module in slot G (real number) 

<value_8>:: = skew for module in slot H (real number) 

< value_9 >^ skew for module in slot I (real number) 

< value_To>:: = skew for module in slot J (real number) 

Example: 10 dim Setting$[100] 

20 OUTPUT XXX;MNTERMODULE:HTIME7" 

30 ENTER XXX:Setting$ 

40 PRINT Settings 
50 END 
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INPort 

Command Syntax: 
Example: 
Query Syntax: 
Returned Format: 
Example: 


command/query 

The INPort command causes Intermodule runs to be armed from the 
Input port. The INPort query returns the current setting. 

:INTermodule:INPort {{ON| 1} | {OFF|0}} 

OUTPUT XXX;-:INTERMODULE:INPORT ON" 

; lNTermodule:INPort? 

[:INTermodule:INPort] {1 |0}<NL> 

10 DIM Setting$[100] 

20 OUTPUT XXX;":INTERMODULE:INPORT?“ 

30 ENTER XXX;Setting$ 

40 PRINT Settings 
50 END 


HP 16500A/16501A 
Programming Reference 


Intermodule Subsystem 

9-5 



INSert 


INSert command 

The INSert command adds a module or PORT OUT to the 
Intermodule configuration. The first parameter selects the module or 
PORT OUT to be added to the intermodule configuration, and the 
second parameter tells the instrument where the module or PORT 
OUT ^ be located. 1..5 corresponds to the slot location of the 
module A...E for the HP 16500A alone and 1...10 modules in slots A.. J 
when an HP 16501A is connected. 

Command Syntax: :INTermodule:INSert { < module > | OUT},{GROUP | < module > } 
where: 

< module >:; = integer, 1 through 5 (HP 16500Aonly), integer 1 through 10 (HP 16501A 
connected) 

Examples: output XXX;*:iNTERMODULE:INSERT 1 ,GROUP" 

OUTPUT XXX;':iNT:iNSERT 2.GROUP* 

OUTPUT XXX;“;INTERMODULE:INS 3,2:iNS OUT,2- 

The following figure sho\\^ the result of the example output commands: 
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SKEW < N > command/query 

The SKEW cxjmmaiid sets the skew value for a module. The query 
returns the user deSned skew setting. The < N > index value is the 
module number (1..J corresponds to the slot location of the module 
A...E for the HP 165(X)A alone and 1...10 modules in slots A.. J when 
an HP 16501A is connected) and the < setting > parameter is the skew 
setting (-1.0 to 1.0) in seconds. 

Command Syntax: :INTermoclule:SKEW<N> <setting > 

where: 

<N>::= integer, 1 through 5 (HP 16500Aonly), integer 1 through 10 (HP 16501A 
connected) 

< setting >:: = -1.0 to 1.0 seconds (real number) 

Example: output XXX;':INTERM0DULE:SKEW2 3.0E-9' 

Query Syntax: :lNTermodule:SKEW< n>? 

Returned Format: [INTermodule:SKEW<N>] <setting><NL> 

Example: 10 dim Setting$[100] 

20 OUTPUT XXX;‘:INTERMODULE:SKEW2?" 

30 ENTER XXX; Settings 
40 PRINT Settings 
50 END 
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TREE command/query 

The TREE command allows an intermodule setup to be specified in 
one command. The query returns a string that represents the 
intermodule tree. A -1 means the module is not in the intermodule 
tree, a 0 value means the module is armed from the Intermodule run 
button (Group run), and a positive value indicates the module is being 
armed by another module with that slot location (1...5 corresponds to 
the slot location of the module A...E for the HP 16500A alone and 
1...10 modules in slots A,. J when an HP 16501A is connected). 

The first five parameters are the intermodule arm values for modules A 
through J respectively. The last parameter corresponds to the 
intermodule arm value for PORT OUT. 

Command Syntax: :INTermodule:TREE 

< module >, < module >, < module >, < module >, < module >, < module > 

where: 

< module >:: = integer, -1 through 5 (HP 16500A only), integer -1 through 10 (HP 16501A 
connected)- 

Example: output XXX;':INTERM0DULE:TREE 0,0,2,-1 ,-1,2* 

The following figure shows the result of the example output commands: 
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TREE 


Query Syntax: 
Returned Format: 

Example: 
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:INTermoclule:TREE? 


[INTermodule:TREE] 

< module >, < module >, < module >, < module > 


10 DIM Config$[100] 

20 OUTPUT XXX;-:INTERMODULE:TREE?" 
30 ENTER XXX;Config$ 

40 PRINT Config$ 

50 END 


< module >, < module >< NL> 
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TTIMe query 

The TTIMe query returns five values (HP 16500A alone) representing 
the absolute intermodule trigger times for all of the modules in the 
Intermodule configuration. When an HP 16501A is connected, the 
TTIMe query returns 10 values. The first value is the trigger time for 
the module in slot A, the second value is for the module in slot B, the 
third value is for slot C, etc. 

The value 9.9E37 is returned when: 

• No module is installed in the corresponding slot; 

• The module in the corresponding slot is not time correlated; or 

• A time correlatable module did not trigger. 

ll^ The trigger times returned by this command have already been offset 
Note iBr by the INTermodulerSKEW values and internal hardware skews 
(INT ermodule:HTlMe). 
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Query Syntax: :INTermoduleilTlMe? 

Returned Format: [;INTermodule:TTIMe] 

< valuel >, < value_2 >, < values >, < value_4 >, < value_5 > 

[, < value_6 >, < value_7 >, < value_8 >, < value_9 >, < value_10 > ] < NL > 

where: 

< value_1 >:: = trigger time for module in slot A (real number) 

<value_2>= trigger time for module in slot B (real number) 

<value_3>:: = trigger time for module in slot C (real number) 

<value_4>:: = trigger time for module in slot D (real number) 

<value_5>:: = trigger time for module in slot E (real number) 

<value_6>:: = trigger time for module in slot F (real number) 

<value_7>:: = trigger time for module in slot G (real number) 

<value_8>= trigger time for module in slot H (real number) 

< value_9 >:: = trigger time for module in slot I (real number) 

<value_10:: = trigger time for module in slot J (real number) 

Examoles: io dim Setting$rioo] 

20 OUTPUT XX)Q‘:INTERMODULE:TTIME?* 

30 ENTER XXX;Setting$ 

40 PRINT Setting! 

50 END 
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Functions 


Introduction This appendix describes the operation of instruments that operate in 

compliance with the IEEE 488.2 (syntax) standard. The IEEE 488J2 
standard is a new standard. Instruments that are compatible with 
IEEE 488.2 must also be compatible with IEEE 488.1 (HP-IB bus 
standard); however, IEEE 488.1 compatible instruments may or may 
not conform to the IEEE 488.2 standard. The IEEE 488.2 standard 
defines the message exchange protocols by which the instrument and 
the controller will communicate. It also defines some common 
capabilities, which are found in all IEEE 488.2 instruments. This 
appendix also contains a few items which are not specifically defined by 
IEEE 488.2. but deal with message communication or system functions. 


The syntax and protocol for RS-232C program messages and response 
Note 'Hr messages for the HP 16500A are structured very similiar to those 
described by 488.2. In most cases, the same structure shown in this 
appendbc for 488.2 will also work for RS-232C. Because of this, no 
additional information has been included for RS-232C. 


Also, the common commands listed in the chapter "Common 
Commands" may be sent over both HP-IB and RS-232C. 
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Protocols 


Functional 

Elements 


The protocols of IEEE 488.2 define the overall scheme used by the 
controller and the instrument to communicate. This includes defining 
when it is appropriate for devices to talk or listen, and what happens 
when the protocol is not followed. 

Before proceeding with the description of the protocol, a few system 
components should be understood. 

Input Buffer. The input buffer of the instrument is the memory area 
where commands and queries are stored prior to being parsed and 
executed. It allows a controller to send a string of commands to the 
instrument which could take some time to execute, and then proceed to 
talk to another instrument while the first instrument is parsing and 
executing commands. 

Output Queue. The output queue of the instrument is the memory 
area where all output data ( < response messages > ) are stored until 
read by the controller. 

Parser. The instrument’s parser is the component that interprets the 
commands sent to the instrument and decides what actions should be 
taken. "Parsing" refers to the action taken by the parser to achieve this 
goal. Parsing and executing of commands begins when either the 
instrument sees a < program message terminator > (defined later in 
this appendix) or the input buffer becomes full. If you wish to send a 
long sequence of commands to be executed and then talk to another 
instrument while they are executing, you should send all the commands 
before sending the < program message terminator >. 


Message Communication and System Functions 
A-2 


HP 16500A/16501A 

Programming Reference 


Protocol Overview 


Protocol 
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The instrument and controller communicate using < program 
message > s and < response message > s. These messages serve as the 
containers into which sets of program commands or instrument 
responses are placed. < program message > s are sent by the 
controller to the instrument, and < response message > s are sent &om 
the instrument to the controller in response to a query message. A 
< query message > is defined as being a < program message > which 
contains one or more queries. The instrument will only talk when it has 
received a valid query message, and therefore has something to say. 

The controller should only attempt to read a response after sending a 
complete query message, but before sending another < program 
message >. The basic rule to remember is that the instrument will only 
talk when prompted to, and it then expects to talk before being told to 
do something else. 

When the instrument is turned on or when it receives a device clear 
command, the input buffer and output queue are cleared, and the 
parser is reset to the root level of the command tree. 


When the instrument receives a device clear command, the module (or 
system) selected prior to the command remains selected. 


The instrument and the controller communicate by exchanging 
complete < program message > s and < response message > s. This 
means that the controller should always terminate a < program 
message > before attempting to read a response. The instrument will 
terminate < response message > s except during a hardcopy output. 

If a query message is sent, the next message passing over the bus should 
be the < response message >. The controller should always read the 
complete < response message > associated with a query message 
before sending another < program message > to the same instrument. 

The instrument allows the controller to send multiple queries in one 
query message. This is referred to as sending a "compound query." As 
will be noted later in this appendix, multiple queries in a query message 
are separated by semicolons. The responses to each of the queries in a 
compound query will also be separated by semicolons. 
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Protocol 

Exceptions 


Commands are executed in the order they are received. This also 
applies to the reception of the HP-IB group execute trigger (GET) bus 
command. The group execute trigger command should not be sent in 
the middle of a < program message >. 

If an error occurs during the information exchange, the exchange may 
not be completed in a normal manner. Some of the protocol 
exceptions are shown below. 

Addressed to talk with nothing to say. If the instrument is addressed 
to talk before it receives a query, it will indicate a query error and will 
not send any bytes over the bus. If the instrument has nothing to say 
because queries requested were unable to be executed because of some 
error, the device will not indicate a query error, but will simply wait to 
receive the next message from the controller. 

Addressed to talk with no listeners on the bus. If the instrument is 
addressed to talk and there are no listeners on the bus, the instrument 
will w^t for a listener to listen, or for the controller to take control. 

Command Error. A command error will be reported if the instrument 
detects a syntax error or an unrecognized command header. An HP-IB 
group execute trigger (GET) sent in the middle of a < program 
message > will also cause a command error. 

Execution Error. An execution error will be reported if a parameter is 
found to be out of range, or if the current settings do not allow 
execution of a requested command or query. 

Device-specific Error. A dewce-specific error will be reported if the 
instrument is unable to execute a command for a strictly device 
dependent reason. 

Query Error. A query error will be reported if the proper protocol for 
reading a query is not followed. This includes the interrupted and 
unterminated conditions described in the following paragraphs. 
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Unterminated Condition. If the controller attempts to read a 
< response message > before terminating the < program message >, a 
query error will be generated. The parser will reset itself, and the 

Will L/W XXOJUA tXtC V/UlpUk kJUWUW KJX kilw lAA^lx UAXAWAAk 

without being sent over the bus. 


Interrupted Condition. If the controller does not read the entire 
< response message > generated by a query message and then 
attempts to send another < program message >, the device will 
generate a query error. The unread portion of the response will then 
be discarded by the instrument. The interrupting < program 
message > will not be affected. 

Buffer Deadlock. The instrument may become deadlocked if the input 
buffer and output queue both become full. This condition can occur if 
a very long < program message > is sent containing queries that 
generate a great deal of response data. The instrument cannot accept 
any more bytes, and the controller cannot read any of the response 
data until it has completed sending the entire < program message >. 
Under this condition the instrument will break the deadlock by clearing 
the output queue, and continuing to discard responses undl it comes to 
the end of the current < program message >. The query error bit will 
also be set. 


The syntax diagrams in this appendix are similar to the syntax diagrams 
in the IEEE 488.2 specification. Commands and queries are sent to the 
instrument as a sequence of data bytes. The allowable byte sequence 
for each functional element is defined by the syntax diagram that is 
shown with the element description. 

The allowable byte sequence can be determined by following a path in 
the syntax diagram. The proper path through the syntax diagram is any 
path that follows the direction of the arrows. If there is a path around 
an element, that element is optional. If there is a path from right to left 
around one or more elements, that element or those elements may be 
repeated as many times as desired. 
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Syntax 

Overview 


This overview is intended to give a quick glance at the syntax defined by 
IEEE 488.2. It should allow you to understand many of the things 
about the syntax you need to know. This appendix also contains the 
details of the IEEE 488.2 defined syntax. 

IEEE 488.2 defines the blocks used to build messages which are sent to 
the instrument. A whole string of commands can therefore be broken 
up into individual components. 

Figure A-1 shows a breakdown of an example < program message >. 
There are a few key items to notice: 

1. A semicolon separates commands from one another. Each 

< program message unit > serves as a container for one 
command. The < program message unit > s are separated by a 
semicolon. 

2. A < program message > is terminated by a < ML > (new line) , a 

< NL > with EOI asserted, or EOI being asserted on the last 
byte of the message. The recognition of the < program message 
terminator >, or < PMT >, by the parser serves as a signal for 
the parser to begin execution of commands. The < PMT > also 
affects command tree traversal (see the Progr amming and 
Documentation Conventions chapter). 

3. Multiple data parameters are separated by a comma. 

4. The first data parameter is separated from the header with one or 
more spaces. 

5. The header INTERMODULEiINSERT is an example of a 
compound header. It places the parser in the intermodule 
subsystem until the <NL> is encountered. 

6. A colon preceding the command header returns you to the top of 
the command tree for the selected module. 


Message Communication and System Functions 
A-6 


HP 16500A/16501A 
Programming Reference 


; INTERMODULE:INSERT 3,1; SKEWS 3.8 ns <NL> 


<prograin message un i t> 
INTERMODULE:INSERT 3 . 1 



<corTniand program header> <program header separator> 
INTERMODULE .-INSERT SP 


<program data> 
3 . 1 





<program mnemoniO 
INTERMODULE 


<program mnemonic> <program data> <progrom data seporolor> <program data> 
INSERT 3 , 1 


<decimal numeric progrom dala> <decimal numeric progrom data> 
3 1 


<program message unit separator> 
SP ; SP 


<program message unit> 



<progrom message terminator> 
SP <NL> 


<white space> NL 


SKEWS 


3.8 ns 


<white space> <decimal progrom data> <suffix program data> 

3.8 SP ns 



i«see/Biis 


<white space> <suffix multiplier> <suffix unil> 

n s 

Figure A-1. < program message > Parse Tree 
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D6ViC6 Listening The listening syntax of IEEE 488.2 is designed to be more forgiving 
Syntex than the talking syntax. This allows greater flexibihty in writing 
programs, as well as allowing them to be easier to read. 

Upper/Lower Case Equivalence. Upper and lower case letters are 
equivalent. The mnemonic SINGLE has the same semantic meaning as 
the mnemonic single. 

< white space >. < white space > is defined to be one or more 
characters from the ASCII set of 0 - 32 decimal, excluding 10 decimal 
(NL). < white space > is used by several instrument listening 
components of the syntax. It is usually optional, and can be used to 
increase the readability of a program. 



54120/BL38 


Figure A-2. < white space > 
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< program message >. The < program message > is a complete 
message to be sent to the instrument. The instrument will begin 
executing commands once it has a complete < program message >, or 
when the input buffer becomes full. The parser is also repositioned to 
the root of the command tree after executing a complete < program 
message >. Refer to the Tree Traversal Rules in the Progr amming and 
Documentation Conventions chapter for more details. 



Figure A-3. < program message > 


< program message unit>. The < program message unit > is the 
container for individual commands within a < program message >. 



Figure A-4. < program message unit> 
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<program data 
separator> 


<connmand 

program 

header> 


<program 

header 

separator> 


<progrom dato> 


54120/BL41 


Figure A-5. < command message unit> 



Figure A-6. < query message unit > 
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< program message unit separator >. A semicolon separates 

< program message unit > s, or individual commands. 



54120/BL43 

Figure A-7. < program message unit separator > 

< command program header > / < query program header >. These 
elements serve as the headers of commands or queries. They represent 
the action to be taken. 



54120/BL44 

Figure A-8. < command program header > 
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Where < simple command program header > is defined as 


<program 
mnemonic> 


S4120/BL4S 


Where < compound command program header > is defined as 



Where < common command program header > is defined as 



Where <programmnemonic> is defined as 



54120/BL45 

Where < upper/lower case alpha > is defined as a single ASCII encoded 
byte in the range 41 - 5A, 61-7A (65- 90, 97 -122 decimal). 


Where <digt> is defined as a single ASCII encoded byte in the range 30 
-39 (48 - 57 decimal). 

Where ( _) represents an "underscore”, a single ASCII-encoded byte with 
the value 5F (95 decimal). 

Figure A-8. < command program header> (continued) 
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M120/Bt4e 

Where < simple query program header > is defined as 



M120/BL46 

Where < compound querypro^am header > is defined as 



Where < common query program header > is defined as 



iA\20m.4^ 


Figure A-9. < query program header > 
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< program data >. The < program data > element represents the 
possible types of data which may be sent to the instrument. The 

HP 16500A will accept the following data types: < character program 
data >, < decimal numeric program data >, < suffix program data >, 

< string program data >, and < arbitrary block program data >. 



<program 
mnemonic> 


MI20/BL4e 


Figure A-11. < character program data > 
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Where < mantisssa > is defined as 



Where < optional digits > is defined as 



Figure A-12. < decimal numeric program data> 


HP 16500A/16501A 
Programming Reference 


Message Communication and System Functions 

A-15 














Figure A-13. < suffix program data> 


Suffix Multiplier. The suffix multipliers that the instrument will accept 
are shown in table A-1. 

TableA-1. <suffixmult> 


Value 

Mnemonic 

1E18 

EX 

1E15 

PE 

1E12 

T 

1E9 

G 

1E6 

MA 

1E3 

K 

lE-3 

M 

lE-6 

U 

lE-9 

N 

lE-12 

P 

lE-15 

F 

lE-18 

A 


Suffix Unit The suffix units that the instrument will accept are shown 
in table A-2. 


Table A-2. < suffix unit > 


Suffix 

Referenced Unit 

V 

Volt 

S 

Second 
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54120/81.53 

Where < inserted ’> is defined as a single ASCII character with the value 
27 (39 decimal). 

Where < non-single quote char > is defined as a single ASCII character 
of any value except 27 (39 decimal). 

Where < inserted "> is defined as a single ASCII character with the value 
22 (34 decimal). 

Where < non-double quote char > is d^ned as a single ASCII character 
of any value except 22 (34 decimal) 

Figure A-14. < string program data> 
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Where < non-zero di^t> is defined as a single ASCII encoded byte in the 
range 31 - 39 (49 - 57 decimal). 

Where < 8-bit byte > is defined as an 8-bit byte in the range 00 - FF (0- 
255 decimal). 

Figure A-15. < arbitrary block program data > 

< program data separator >. A comma separates multiple data 
parameters of a command from one another. 



S4t20/BL5S 


Figure A-16. < program data separator > 
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< program header separator >. A space separates the header from 
the first or only parameter of the command. 


<white space> 


M120/8L56 


Figure A-17. < program header separator > 


< program message terminator >. The < program message 
terminator > or <PMT > serves as the terminator to a complete 

< program message >. When the parser sees a complete < program 
message > it will begin execution of the commands within that 
message. The < PMT > also resets the parser to the root of the 
command tree. 



Where <NL> is defined as a single ASCII-encoded byte QA (10 
decimal). 

Figure A>18. < program message terminator > 
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: INTERMODULE:INPORT 1INTERMODULE:SKEW3 3.8E-9 <NL> 



<response header> <response header separalor> <response dala> 

: INTERMODULE:SKEW3 SP 3.8E-9 



<response mnemonic> <response mnemonic> <white space> <NR3 numeric response data> 
INTERMODULE SKEW3 3.8E-9 

i6see/8Li9 

Figure A*19. < response message > Tree 
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DGViC6 T alking The talking syntax of IEEE 488.2 is designed to be more precise than 
Syntax listening syntax. This allows the programmer to write routines 

which can easily interpret and use the data the instrument is sending. 
One of the implications of this is the absence of < white space > in the 
talking formats. The instrument will not pad messages which are being 
sent to the controller with spaces. 

< response message >. This element serves as a complete response 
from the instrument. It is the result of the instrument executing and 
buffering the results from a complete < program message >. The 
complete < response message > should be read before sending 
another < program message > to the instrument. 



< response message unit>. This element serves as the container of 
individual pieces of a response. Typically a < query message unit > 
will generate one < response message unit >, although a < query 
message unit > may generate multiple < response message unit > s. 

< response header >. The < response header >, when returned, 
indicates what the response data represents. 
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MIZO/BL^e 

Where < simple response mnenomio is defined as 


<response 
mnemonic> 


S4izo/ai.s9 


Where < compound response header > is defined as 



<response 
mnemonic> 




<response 
mnemonic> 


Mizo/Bteo 


Where < common response header > is defined as 





<response 
mnemonic> 


S4120/BL61 

Figure A-21. < response message unit> 
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Where < response mnemonio is defined as 



Where < uppercase alpha > is defined as a single ASCII encoded byte in 
the range 41-5A (65 - 90 decimal). 


Where ( _) represents an Underscore", a single ASCII-encoded byte with 
the value 5F (95 decimal). 

Figure A-21. < response message unit > (Continued) 

< response data >. The < response data > element represents the 
various types of data which the instrument may return. These types 
include: < character response data >, < nrl numeric response data >, 

< nr3 numeric response data >, < string response data >, < definite 
length arbitrary block response data >, and < arbitrary ASCII 
response data >. 


<response 


irmemon i c> 



S4l20/BLe3 


Figure A-22. < character response data > 
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Figure A-23. < nr1 numeric response data > 



Figure A-24. < nr3 numeric response data > 



&4120/BLSS 

Figure A-25. < string response data > 
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54120/BL67 

Figure A-26. < definite length arbitrary block response data > 



except <NL> (QA, 10 decimal). 


.. . Ilia 1 The END message provides an unambiguous termination to an 
Not© SlF element that contains arbitrary ASCII characters. 


2. The IEEE 488.1 END message serves the dual function of 

terminating this element as well as terminating the < RESPONSE 
MESSAGE >. It is only sent once with the last byte of the indefinite 
block data. The NL is present for consistency with the 
< RESPONSE MESSAGE TERMINATOR >. Indefinite block 
data format is not supported in the HP 16500A. 


Figure A-27. < arbitrary ASCII response data> 
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< response data separator >. A comma separates multiple pieces of 
response data within a single < response message unit >. 



&4120/BL69 

Figure A-28. < response data separator > 

< response header separator >. A space (ASCII decimal 32) delimits 
the response header, if returned, from the first or only piece of data. 

Figure A-29. < response header separator > 



&4t20/BL70 

< response message unit separator >. A semicolon delimits the 

< response message unit > s if multiple responses are returned. 



54120/BL71 

Figure A-30. < response message unit separator > 

< response message terminator >. A < response message 
terminator > (NL) terminates a complete < response message >. It 
should be read from the instrument along with the response itself. 



If you do not read the < response message terminator > the 
HP 16500A will produce an interrupted error. 
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Common 

Commands 


IEEE 488.2 defines a set of common commands. These commands 
perform functions which are common to any type of instrument. They 
can therefore be implemented in a standard way across a wide variety 
of instrumentation. All the common commands of IEEE 488.2 be^ 
with an asterisk. There is one key difference between the IEEE 488.2 
common commands and the rest of the commands found in this 
instrument. The IEEE 488.2 common commands do not affect the 
parser’s position within the command tree. More information about 
the command tree and tree traversal can be found in the Programming 
and Documentation Conventions chapter. 

Table A-3. HP 16500A’s Common Commands 


Command 

Command Name 

^ r\ 

Clear Status Command 

*ESE 

Event Status Enable Command 

♦ESE? 

Event Status Enable Query 

•ESR? 

Event Status Register Query 

•IDN? 

Identification Query 

*IST? 

Individual Status Query 

*OPC 

Operation Complete Command 

*OPC? 

Operation Complete Query 

*OPT? 

Option Identification Query 

♦PRE 

Parallel Poll Enable Register Enable Command 

*PRE? 

Parallel Poll Enable Register Enable Query 

*RST 

Reset (not implemented on HP 16500A) 

♦SRE 

Service Request Enable Command 

*SRE? 

SerNice Request Enable Query 

•STB? 

Read Status Byte Query 

•TRG 

Trigger Command 

•TST? 

Self-Test Query 

•WAI 

Wait-to-Continue Command 
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Status Repcrtlnq 


Introduction The status reporting features which are available over the bus include 

the serial and parallel polls. IEEE 488.2 defines data structures, 
commands, and common bit definitions for each. There are also 
instrument defined structures and bits. 

The bits in the status byte act as summary bits for the data structures 
residing behind them. In the case of queues, the summary bit is set if 
the queue is not empty. For registers, the summary bit is set if any 
enabled bit in the event register is set. The events are enabled via the 
corresponding event enable register. Events captured by an event 
register remain set until the register is read or cleared. Registers are 
read with their assodated commands. The "*CLS" command clears all 
event registers and all queues except the output queue. If "*CLS" is 
sent immediately following a < program message terminator > , the 
output queue will also be cleared. 
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NOTE: THE INDIVIDUAL BIT ASSIGNMENTS FOR THE MODULE EVENT REGISTERS ARE MODULE SPECIFIC. 
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Figure B-1. Status Byte Structures and Concepts 


Status Reporting 
B-2 


HP 16500A/16501A 
Programming Reference 











Event StStUS The Event Status Renter is a 488.2 defined register. The bits in this 
Register renter are "latched." That is, once an event happens which sets a bit, 
that bit will only be cleared if the register is read. 

Service Request The Service Request Enable Register is an 8-bit register. Each bit 
Endbie Register enables the corresponding bit in the status byte to cause a service 

request. The sixth bit does not logically ejdst and is always returned as 
a zero. To read and write to this register use the *SRE? and *SRE 
commands. 

Bit Definitions MAY • message available. Indicates whether there is a response in the 

output queue. 

ESB - event status bit Indicates if any of the conditions in the 
Standard Event Status Register are set and enabled. 

MSS • master summary status. Indicates whether the device has a 
reason for requesting service. This bit is returned for the *STB? query. 

RQS - request service. Indicates if the device is requesting service. 

This bit is returned during a serial poll. RQS will be set to 0 after being 
read via a serial poll (MSS is not reset by *STB?). 

PON - power on. Indicates power has been turned on. 

URQ - user request. Always 0 on the HP 16500A. 

CME • command error. Indicates whether the parser detected an 
error. 

The error numbers and/or strings for CME, EXE, DDE, and QYE can 
be read from a device defined queue (which is not part of 4882) with 
the query :SYSTEM:ERROR?. 

EXE • execution error. Indicates whether a parameter was out of 
range, or inconsistent with current settings. 

DDE - device specific error. Indicates whether the device was unable 
to complete an operation for device dependent reasons. 
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QYE - query error. Indicates whether the protocol for queries has 
been violated. 

RQC - request control. Always 0 on the HP 16500A. 

OPC - operation complete. Indicates whether the device has 
completed all pending operations. OPC is controlled by the *OPC 
co mm on command. Because this command can appear after any other 
command, it serves as a general purpose operation complete message 
generator. 

LCL - remote to local. Indicates whether a remote to local transition 
has occurred. 

MSB - module summaiy bit. Indicates that an enable event in one of 
the modules Status registers has occurred. 

Koy FOSturOS a few of the most important features of Status Reporting are listed in 

the following paragraphs. 

Operation Complete. The IEEE 488.2 structure provides one 
technique which can be used to find out if any operation is finished. 
The *OPC command, when sent to the instrument after the operation 
of interest, will set the OPC bit in the Standard Event Status Register. 
If the OPC bit and the RQS bit have been enabled a service request 
will be generated. The commands which affect the OPC bit are the 
overlapped commands. 

OUTPUT XXX;"*SRE 32; *ESE 1" lenabies an OPC service request 

Status Byte. The Status Byte contains the basic status information 
which is sent over the bus in a serial poll. If the device is requesting 
service (RQS set), and the controller serial polls the device, the RQS 
bit is cleared. The MSS (Master Summary Status) bit (read ^th 
*STB?) and other bits of the Status Byte are not be cleared by reading 
them. Only the RQS bit is cleared when read. To see how the RQS 
and MSS bits are set and used, see figure B-2. 

The Status Byte is cleared \wth the *CLS common command. 
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■STATUS SUMMARY MESSAGES- 





- READ 

- STATUS BIT 

- READ 


/ 


BY SERIAL POLL 

REGISTER 

BY »STB? 


SERVICE REQUEST 
ENABLE REGISTER 
*SRE <NRf> 


• SRE? 


I$5M/BL24 


Figure B-2. Service Request Enabling 
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Serial Poll 


Using Serial Poll 
(HP-IB) 
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The HP 16500A supports the IEEE 488.1 serial poll feature. When a 
serial poll of the instrument is requested, the RQS bit is returned on bit 
6 of the status byte. 

This example will show how to use the service request by conducting a 
serial poll of all instruments on the HP-IB bus. In this example, assume 
that there are two instruments on the bus; a Logic Analysis System at 
address 7 and a printer at address 1. 

The program command for serial poll using HP BASIC 4.0 is Stat = 
SPOLL(707). The address 707 is the address of the Logic Analysis 
System in the this example. The command for checking the printer is 
Stat = SPOLL(701) because the address of that instrument is 01 on 
bus address 7. This command reads the contents of the HP-IB Status 
Byte Register into the variable called Stat. At that time bit 6 (RQS bit) 
of the variable Stat can be tested to see if it is set (bit 6 = 1). 

The serial poll operation can be conducted in the foUowmg manner: 

1. Enable interrupts on the bus. This allows the controller to "see" 
the SRQ line. 

2. Disable interrupts on the bus. 

3. If the SRQ line is high (some instrument is requesting service) 
then check the instrument at address 1 to see if bit 6 of its status 
renter is high. 
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4. To check whether bit 6 of an instruments status register is high, 
use the following Basic statement: 

!F B!T (Stat, 6) THEN 

5. If bit 6 of the instrument at address 1 is not high, then check the 
instrument at address 7 to see if bit 6 of its status register is high. 

6. As soon as the instrument with status bit 6 high is found check the 
rest of the status bits to determine what is required. 

The SPOLL(707) command causes much more to happen on the bus 
than simply reading the register. This command clears the bus 
automatically, addresses the talker and listener, sends SPE (serial poll 
enable) and SPD (serial poll disable) bus commands, and reads the 
data. For more information about serial poU, refer to your controller 
manual, and programming language reference manuals. 

After the serial poll is completed, the RQS bit in the HP 16500A Status 
Bvte Rerister will be reset if it was set. Once a bit in the Status Bvte 
Register is set, it will remain set until the status is cleared with a *CLS 
command, or the instrument is reset. 
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Parallel Poll 


Parallel poll is a controller initiated operation which is used to obtain 
information from several devices simultaneously. When a controller 
initiates a Parallel Poll, each device returns a Status Bit via one of the 
DIO data lines. Device DIO assignments are made by the controller 
using the PPG (Parallel Poll Configure) sequence. Devices respond 
either individually, each on a separate DIO line; collectively on a single 
DIO line; or any combination of these two ways. When responding 
collectively, the result is a logical AND (True High) or logical OR 
(True Low) of the groups of status bits. 

Figure B-3 shows the Parallel Poll Data Structure. The s ummar y bit is 
sent in response to a Parallel Poll. This summary bit is the "ist" 
(individual status) local message. 

The Parallel Poll Enable Register determines which events are 
summarized in the ist. The ‘PRE command is used to write to the 
enable register and the *PRE? query is used to read the register. The 
*IST? query can be used to read the "ist" without doing a parallel poll. 
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STATUS BYTE 
REGISTER 
•51 B Y 



PARALLEL POLL 
ENABLE REGISTER 

• PRE 

• PRE? 


165M/BL2* 


I Poll Data Structure 













Polling HP-IB Parallel Poll is the fastest means of gathering device status when 
DGVICGS several devices are connected to the bus. Each device (with this 

capability) can be programmed to respond with one bit of status when 
parallel polled. This makes it possible to obtain the status of several 
devices in one operation. If a device responds affirmatively to a 
parallel poll, more information about its specific status can be obtained 
by conducting a serial poll of the device. 

Certain devices, including the HP 16500A, can be remotely 
programmed by a controller to respond to a parallel poll. A device 
which is currently configured for a parallel poll responds to the poll by 
placing its current status on one of the bus data lines. The response 
and the data-bit number can then be programmed by the PPC (parallel 
Poll Configure) statement. No multiple listeners can be specified in 
this statement. If more than one device is to respond on a single bit, 
each device must be configured with a separate PPC statement. 

Example: assign ©Device TO 707 

PPOLL CONFIGURE @Device;Mask 

The value of Mask (any numeric expression can be specified) is first 
rounded and then used to configure the device’s parallel response. The 
least significant 3 bits (bits 0 through 2) of the expression are used to 
determine which data line the device is to respond on (place its status 
on). Bit 3 specifies the "true” state of the parallel poll response bit of 
the device. A value of 0 implies that the device’s response is 0 when its 
status bit message is true. 

Example: The following statement configures the device at address 07 on the 

interface select code 7 to respond by placing a 0 on bit 4 when its status 
response is "true." 

PPOLL CONFIGURE 707:4 


Configuring 
Parallel Poll 
Responses 
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CondUCtinQ 3 The PPOLL (Parallel Poll) function returns a single byte containing up 
PsrSliGl Poll to 8 status bit messages for all devices on the bus capable of responding 
to the poll. Each bit returned by the function corresponds to the status 
bit of the device(s) configured to respond to the parallel poll (one or 
more devices can respond on a single line). The PPOLL function can 
only be executed by the controller. It is initiated by the simultaneous 
assertion of ATN and EOI. 

Example: Response = PPOLL(7) 

DiSSbling PdrsIlGl The PPU (Parallel Poll Unconfigure) statement gives the controller the 
Poll RGSponSGS capability of disabling the parallel poll responses of one or more 

devices on the bus. 

Examples: The following statement disables device 5 only: 

PPOLL UNCONRGURE 705 

This statement disables all devices on interface select code 8 from 
responding to a parallel poll: 

PPOLL UNCONRGURE 8 

If no primary address is specified^ all bus devices are disabled from 
responding to a parallel poll. If a primary address is spedfied, only the 
specified devices (which have the parallel poll configure capability) are 
disabled. 
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HP'IB CommdndS The following paragraphs describe actual HP-IB commands which can 

be used to perform the functions of the Basic commands shown in the 
previous examples. 

Parallel Poll Unconfigure Command. The parallel poll unconfigure 
command (PPU) resets all parallel poll devices to the idle state (unable 
to respond to a parallel poll). 

Parallel Poll Configure Command. The parallel poll configure 
command (PPC) causes the addressed listener to be configured 
according to the parallel poll enable secondary command PPE. 

Parallel Poll Enable Command. The parallel poll enable secondary 
command (PPE) configures the devices which have received the PPC 
command to respond to a parallel poll on a particular HP-IB DIO line 
with a particular level. 

Parallel Poll Disable Command. The parallel poll disable secondary 
command (PPD) disables the devices which have received the PPC 
command from responding to the parallel poll. 

Table B-1. Parallel Poll Commands 


Command 

Mnemonic 

Decimal 

Code 

ASCII/ISO 

Character 

Parallel Poll Unconfigure 
(Multiline Command) 

PPU 

21 

NAK 

Parallel Poll Configure 
(Addressed Command) 

PPC 

05 

ENQ 

Parallel Poll Enable 
(Secondary Command) 

PPE 

96-111 

I-O 

Parallel Poll Disable 
(Secondary Command) 

PPD 

112 

P 
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Error Mssssqbs 


c 


Device 
Dependent Errors 


This section covers the error messages that relate to the HP 16500A 
mainframe and modules. 

200 Label not foimd 

201 Pattern string invalid 

202 Qualifier invalid 

203 Data not available 
300 RS-232C error 
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Command Errors 


-100 Command error (unknown command) (generic error) 

-101 Invalid character received 

-110 Command header error 

-111 Header delimiter error 

-120 Numeric argument error 

-121 Wrong data type (numeric expected) 

-123 Numeric overflow 
-129 Missing numeric argument 

-130 Non numeric argument error (character,string, or block) 
-131 Wrong data type (character expected) 

-132 Wrong data type (string expected) 

-133 Wrong data type (block type #D required) 

-134 Data overflow (string or block too long) 

-139 Missing non numeric argument 
-142 Too many arguments 
-143 Argument delimiter error 
-144 Invalid message unit delimiter 
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Execution Errors 
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-200 No Can Do (generic execution error) 

-201 Not executable in Local Mode 

-202 Settings lost due to retum-to-local or power on 

-203 Trigger ignored 

-211 Legal command, but settings conflict 

-212 Argument out of range 

-221 Busy doing something else 

-222 Insufficient capability or configuration 

-232 Output buffer full or overflow 

-240 Mass Memory error (generic) 

-241 Mass storage derice not present 

-242 No media 

-243 Bad media 

-244 Media full 

-245 Directory full 

-246 File name not found 

-247 Duplicate file name 

-248 Media protected 
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Internal Errors 


-300 Device Failure (generic hardware error) 

-301 Interrupt fault 

-302 System Error 

-303 Time out 

-310 RAM error 

-311 RAM failure (hardware error) 

-312 RAM data loss (software error) 

-313 Calibration data loss 
-320 ROM error 
-321 ROM checksum 

-322 Hardware and Firmware incompatible 
-330 Power on test failed 
-340 Self Test failed 

-350 Too Many Errors (Error queue overflow) 
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Query Errors -400 Query Error (generic) 

-410 Query INTERRUPTED 
-420 Query UNTERMINATED 

-421 Query received. Indefinite block response in progress 
-422 Addressed to Talk, Nothing to Say 
-430 Query DEADLOCKED 
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*CLS command, 5-4 
*ESE command, 5-5 
*ESR command, 5-7 
*IDN command, 5-9 
*IST command, 5-10 
*OPC command, 5-12 
*OPT command, 5-13 
*PRE command, 5-14 
*RST command, 5-16 
*SRE command, 5-17 
*STB command, 5-19 
*TRG command, 5-21 
*TST command, 5-22 
*WAI command, 5-24 
32767, 4-6 
9.9E-h37, 4-6 
, 4-7 

A 


Addressed talk/listen mode, 2-2 
Addressing the instrument 
HP-IB, 1-4 
RS_232C, 1-4 
Angular brackets, 1-3,4-7 
AUToload command, 8-4 
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Baud rate, 3-6 
BEEPer command, 6-3 
Binary, 1-10 
Bit definitions, B-3 
Braces, 4-7 


Cable 

RS-232C, 3-2 
CAPability command, 6-4 
Card identification numbers, 6-5 
CARDcage command, 6-5 
CARDcage query, 1-15 
CATalog command, 8-5 
CESE command, 6-7 
CESR command, 6-9 
Character data, 1-10,1-18 
Character program data, 1-10,1-18 
Clear To Send (CTS), 3-5 
CME, B-3 
Command, 1-5,1-17 
•CLS, 5-4 
*ESE, 5-5 

c lo 

*PRE, 5-14 
*RST, 5-16 
*SRE, 5-17 


index-1 


Command (continued) 

*TRG, 5-21 
*WAI, 5-24 
AUToload, 8-4 
BEEPer, 6-3 
CESE, 6-7 
COPY, 8-6 
DATA, 7-3 
DELete, 9-3 
DOWNload, 8-7 
DSP, 7-6 
EOI, 6-11 
HEADer, 1-17,7-8 
INTTialize, 8-9 
INPort, 9-5 
INSert, 9-6 
LOAD:CONFig, 8-10 
LOADrIASSembler, 8-11 
Lockout, 3-8,6-13 
LONGform, 1-17,7-9 
MENU, 6-14 
MESE, 6-16 
MSI, 8-12 
PACK, 8-13 
PRINt, 7-10 
PURGe, 8-14 
REName, 8-15 
RMODe, 6-20 
SELect, 1-13,6-21 
SETColor, 6-23 
SETup, 7-11 
SKEW, 9-7 
STARt, 6-24 
STOP, 6-25 
STOReiCONFig, 8-16 
TREE, 9-8 

Command cross-reference, 4-12 
Command errors, C-2 
Command header, 1-5 
Command mode, 2-1 
Command set organization, 4-11 

index-2 


Command structure, 1-14,4-8 
Co mman d tree, 4-2 - 4-3 
SELect, 6-22 
Command types, 4-2 
Commands 

Expansion frame, 4-8 
Mainframe, 4-8 
Common command header, 1-7 
Common commands, 4-2,4-8,5-1, A-27 
Compound command header, 1-6 
Compound header, 4-4 
Configuration file, 1-12,1-15 
Controller mode, 2-2 
RS-232C, 3-6 
Controllers, 1-2 
COPY command, 8-6 

D 


Data bits, 3-6 - 3-7 

Data Carrier Detect (DCD), 3-5 

DATA command, 7-3 

Data Communications Equipment, 3-2 

Data mode, 2-1 

Data Set Ready (DSR), 3-5 

Data Terminal Equipment, 3-2 

Data Terminal Ready (DTR), 3-4 

DCE, 3-2 

DCL, 2-5 

DDE, B-3 

Decimal, 1-10 

Definite-length block response data, 1-20 
Definitions, 4-7 
DELete command, 9-3 
Device address 
HP-IB, 1-4,2-3 
RS-232C, 1-4,3-8 
Device clear, 2-5 
Device dependent errors, C-1 
DOWNload command, 8-7 
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DSP command, 7-6 
DTE, 3-2 


E 

Ellipsis, 4-7 
Enter statement, 1-2 
EOI, 1-10 
EOI command, 6-11 
ERRor command, 7-7 
Error messages, C-1 
ESB, B-3 

Event Status Register, B-3 
EXE, B-3 

Execution errors, C-3 
Expansion frame commands, 4-8 
Extended interface, 3-4 

F 


File types, 8-8 

G 

GET, 2-5 

Group execute trigger, 2-5 

H 


HEADer command, 1-17,7-8 
Hexadecimal, 1-10 
HP-IB, 1-4,2-1 - 2-2, A-1, B-6 
HP-IB address, 2-2 
HP-IB commands, B-12 
HP-IB device address, 2-3 


HP-IB interface, 2-2 
HP-IB interface code, 2-3 
HP-IB interface functions, 2-1 
HTIMe query, 9-4 

I 

IEEE 488.1, 2-1,3-1, A-1 
IEEE 488.1 bus commands, 2-5 
IEEE 4882, 3-1, A-1 
IFC, 2-5 
Infinity, 4-6 
Initialization, 1-12 
INTTialize command, 8-9 
INPort command, 9-5 
Input buffer, A-2 
INSert command, 9-6 
Instrument address, 2-3 
HP-IB, 1-4 

Interface capabilities, 2-1 
RS-232C, 3-6 
Interface clear, 2-5 
Interface code 
HP-IB, 2-3 

Interface select code, 1-4 
HP-IB, 1-4 
RS-232C, 3-8 

INTermoduIe subsystem, 9-1 
Internal errors, C-4 
IntemalO, 4-7 
Intemall, 4-7 

L 

T r^r Ty a 
JD-*t 

LER command, 6-12 
Linefeed, 4-7 
Listening syntax, A-8 
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LOADrCONFig command, 8-10 
LOAD;IASSembler command, 8-11 
Local, 2-4 
Local lockout, 2-4 
Lockout command, 3-8,6-13 
Longfonn, 1-9 

LONGform command, 1-17,7-9 
Lowercase, 1-9 

M 


Mainframe commands, 4-2,4-8,6-1 
Mass storage unit specifier, 4-7 
MAV, B-3 

MENU command, 6-14 
MESE command, 6-16 
MESR command, 6-18 
Message terminator, 1-3 
MMEMory subsystem, 8-1 
MSB, B-4 
MSI command, 8-12 
MSS, B-3 
msus, 4-7,8-1 

Multiple data parameters, 1-9 
Multiple numeric variables, 1-21 
Multiple program commands, 1-11 
Multiple queries, 1-21 
Multiple subsystems, 1-11 

N 


NL, 1-10,4-7 
Notation conventions, 4-7 
Numeric base, 1-10,1-18 
Numeric data, 1-10 
Numeric program data, 1-10 
Numeric variables, 1-20 


o 


Octal, 1-10 
OPC, B-4 

Operation Complete, B-4 

OR notation, 4-7 

OUTPUT command, 1-3 

Output queue, A-2 

Output statement, 1-2 

Overlapped command, 5-12,5-24,6-24 - 6-25 

Overlapped commands, 4-6 

P 


PACK command, 8-13 

Parallel poll, B-8 

Parallel poll commands, B-12 

Parity, 3-6 

Parse tree, A-7 

Parser, A-2 

PON, B-3 

PPC, B-12 

PPD, B-12 

PPE, B-12 
PPU, B-12 

PRINt command, 7-10 
Printer, 4-9 
Printer mode, 2-2 
RS-232C, 3-6 
Program command, 1-5 
Program data, 1-9, A-14 
Program examples, 4-9 
Program message, 1-5, A-9 
Program message syntax, 1-5 
Program message terminator, 1-10 
Program message unit, 1-5 
Program query, 1-5 
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Program syntax, 1-5 

Query (continued) 

Programming examples, 1-1 

MESR, 6-18 

Protocol, 3-6, A-3 

MSI, 8-12 

None, 3-6 

PRINt, 7-10 

XON/XOFF, 3-7 

RMODe, 6-20 

Protocol exceptions, A-4 

SELect, 6-21 

Protocols, A-2 

SETColor, 6-23 

PURGe command, 8-14 

SETup, 7-11 

SKEW, 9-7 

Q 

TREE, 9-8 

TTIMe, 9-10 

UPLoad, 8-17 

Query, 1-5,1-8,1-17 
*ESE, 5-5 
*ESR, 5-7 
♦IDN, 5-9 

Query command, 1-8 

Query errors, C-5 

Query response, 1-16 

Query responses, 4-6 
Question mark, 1-8 

♦1ST, 5-10 
♦QPC, 5-12 

QYE, B-4 

•OPT, 5-13 
♦PRE, 5-14 
♦SRE, 5-17 
♦STB, 5-19 

R 

♦TST, 5-22 

Receive Data (RD), 3-3 - 3-4 

AUToload, 8-4 

Remote, 2-4 

BEEPer, 6-3 

Remote enable, 2-4 

CAPabUity, 6-4 

REN, 2-4 

CARDcage, 1-15,6-5 

REName command, 8-15 

CATalog, 8-5 

Request To Send (RTS), 3-4 

CESE, 6-7 

Response data, 1-20 

CESR, 6-9 

Response message, A-21 

DATA, 7-3 

RMODe command, 6-20 

EOI, 6-11 

Root, 4-2,4-4,4-9 

ERRor, 7-7 

RQC, B-4 

FTIMe, 9-4 

RQS, B-3 

HEADer, 7-8 

INPort, 9-5 

RS-232C, 1-4,3-1,3-8, A-1 

LER, 6-12 


LOCKout, 6-13 

LONGform, 7-9 

MENU, 6-15 

MESE, 6-16 
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SDC, 2-5 

SELect command, 1-13,6-21 
Select command tree, 6-22 
Selected device clear, 2-5 
Selecting a module, 1-13 
Separator, 1-5, A-18 
Sequential commands, 4-6 
Serial poll, B-6 

Service Request Enable Register, B-3 

SETColor command, 6-23 

SETup command, 7-11 

Shortform, 1-9 

Simple command header, 1-5 

SKEW command, 9-7 

sp, 4-7 

Square brackets, 4-7 

STARt command, 6-24 

Status, 1-21,5-2, B-1 

Status byte, B-4 

Status registers, 1-21 

Status reporting, B-1 

Stop bits, 3-6 

STOP command, 6-25 

STORe:CONFig command, 8-16 

String variables, 1-19 

Subsystem 

INTermodule, 9-1 
MMEMory, 8-1 
SYSTem, 7-1 

Subsystem commands, 4-2,4-9 
Suffix multiplier. A-16 
Suffix units, A-16 
Syntax, A-8 
Syntax diagram, 4-8 

Common commands, 5-3 
IEEE 488.2, A-5 
INTermodule subsystem, 9-1 - 9-2 


Syntax diagram (continued) 

Mainframe commands, 6-1 - 6-2 
MMEMory subsystem, 8-1 - 8-3 
SYSTem subsystem, 7-1 - 7-2 
SYSTem subsystem, 7-1 

T 

Talk only mode, 2-2 
Talking syntax, A-21 
Talking to the Instrument, 1-2 
HP16500A, 1-2 
HP16501A, 1-2 
Terminator, 1-3,1-10, A-26 
Three-wire Interface, 3-3 
Trailing dots, 4-7 
Transmit Data (TD), 3-3 - 3-4 
TREE command, 9-8 
Tree traversal rules, 4-4 
Truncation rule, 4-1 
TTIMe query, 9-10 

u 

UPLoad command, 8-17 
Uppercase, 1-9 
URQ, B-3 

w 

White space, 4-7 

X 


XXX, 1-12,1-14,1-19,4-4,4-7 
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